@xzzpig/pi-subagents 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (86) hide show
  1. package/CHANGELOG.md +13 -4
  2. package/README.md +1 -1
  3. package/agents/reviewer.md +12 -2
  4. package/docs/agents.md +4 -4
  5. package/docs/configuration.md +6 -6
  6. package/docs/extension-api.md +14 -4
  7. package/docs/models.md +47 -6
  8. package/docs/observability.md +14 -3
  9. package/docs/tool-reference.md +21 -6
  10. package/docs/workflows.md +7 -1
  11. package/index.ts +10 -1
  12. package/package.json +3 -3
  13. package/prompts/council.md +19 -7
  14. package/prompts/parallel-review.md +5 -1
  15. package/prompts/review-loop.md +9 -5
  16. package/skills/council-mode/SKILL.md +50 -26
  17. package/skills/pi-subagents/SKILL.md +5 -1
  18. package/skills/pi-subagents/references/constraints-and-recipes.md +16 -1
  19. package/skills/pi-subagents/references/execution-controls.md +13 -4
  20. package/skills/pi-subagents/references/multi-lane-orchestration.md +3 -3
  21. package/skills/pi-subagents/references/prompting-and-roles.md +14 -7
  22. package/src/agents/agent-management.ts +115 -14
  23. package/src/agents/agent-serializer.ts +4 -2
  24. package/src/agents/agents.ts +226 -48
  25. package/src/api/external-job-provider.ts +10 -1
  26. package/src/api/preflight.ts +52 -19
  27. package/src/api/project-panes.ts +2 -0
  28. package/src/extension/doctor.ts +10 -0
  29. package/src/extension/fanout-child.ts +3 -2
  30. package/src/extension/index.ts +24 -4
  31. package/src/extension/public-execution.ts +12 -9
  32. package/src/extension/rpc.ts +77 -3
  33. package/src/extension/schemas.ts +7 -1
  34. package/src/extension/tool-description.ts +9 -6
  35. package/src/extension/tool-result.ts +19 -0
  36. package/src/inspectors/herdr/client.ts +3 -3
  37. package/src/inspectors/herdr/focus.ts +55 -0
  38. package/src/inspectors/herdr/project-panes.ts +228 -44
  39. package/src/integrations/herdr-status.ts +26 -4
  40. package/src/runs/background/async-execution.ts +146 -17
  41. package/src/runs/background/async-job-tracker.ts +33 -14
  42. package/src/runs/background/async-resume.ts +23 -2
  43. package/src/runs/background/async-retention.ts +1 -1
  44. package/src/runs/background/async-status.ts +10 -0
  45. package/src/runs/background/chain-root-attachment.ts +5 -0
  46. package/src/runs/background/control-channel.ts +98 -10
  47. package/src/runs/background/notify.ts +62 -1
  48. package/src/runs/background/result-watcher.ts +4 -3
  49. package/src/runs/background/run-status.ts +15 -1
  50. package/src/runs/background/stale-run-reconciler.ts +3 -0
  51. package/src/runs/background/subagent-runner.ts +333 -48
  52. package/src/runs/background/wait-completions.ts +2 -0
  53. package/src/runs/background/wait-tool.ts +4 -3
  54. package/src/runs/foreground/async-stop-action.ts +23 -2
  55. package/src/runs/foreground/execution.ts +148 -13
  56. package/src/runs/foreground/foreground-history.ts +3 -2
  57. package/src/runs/foreground/subagent-executor.ts +417 -50
  58. package/src/runs/foreground/workflow-detach-reconcile.ts +18 -6
  59. package/src/runs/shared/acceptance.ts +11 -5
  60. package/src/runs/shared/agent-contract.ts +1 -1
  61. package/src/runs/shared/child-identity.ts +36 -0
  62. package/src/runs/shared/completion-guard.ts +52 -2
  63. package/src/runs/shared/dynamic-fanout.ts +1 -1
  64. package/src/runs/shared/extension-bindings.ts +78 -0
  65. package/src/runs/shared/external-cli-runner.ts +2 -0
  66. package/src/runs/shared/external-job-bridge.ts +53 -37
  67. package/src/runs/shared/external-job-runner.ts +126 -23
  68. package/src/runs/shared/fast-mode-extension.ts +10 -0
  69. package/src/runs/shared/model-exclusions.ts +2 -1
  70. package/src/runs/shared/model-fallback.ts +48 -22
  71. package/src/runs/shared/model-scope.ts +106 -39
  72. package/src/runs/shared/mutation-evidence.ts +145 -0
  73. package/src/runs/shared/orca-progress-tabs.ts +71 -9
  74. package/src/runs/shared/parallel-utils.ts +15 -0
  75. package/src/runs/shared/pi-args.ts +78 -1
  76. package/src/runs/shared/structured-output.ts +18 -4
  77. package/src/runs/shared/subagent-prompt-runtime.ts +48 -15
  78. package/src/runs/shared/tool-availability.ts +1 -3
  79. package/src/shared/launch-contract.ts +12 -5
  80. package/src/shared/settings.ts +6 -1
  81. package/src/shared/thinking-ceiling.ts +52 -0
  82. package/src/shared/types.ts +120 -5
  83. package/src/tui/fleet-status.ts +66 -13
  84. package/src/tui/render.ts +5 -4
  85. package/src/watchdog/permission-arbiter.ts +59 -52
  86. package/src/workflows/scripted-workflow.ts +156 -12
@@ -11,7 +11,7 @@ import { createCapacityResilientJsonWriter } from "../../shared/capacity-resilie
11
11
  import { isStorageCapacityError } from "../../shared/file-system-retry.ts";
12
12
  import { updateActiveRunIndex } from "./active-run-index.ts";
13
13
  import { createChildTranscriptWriter, type ChildTranscriptWriter } from "../../shared/child-transcript.ts";
14
- import { closeSteerInbox, consumeInterruptRequest, consumeSteerRequests, deliverInterruptRequest, deliverStopRequest, deliverTimeoutRequest, enqueueStepSteer, steerAcksDir, steerCapabilityPath, stepSteerInboxDir, watchAsyncControlInbox, type SteerAck, type SteerCapability, type SteerRequest } from "./control-channel.ts";
14
+ import { closeSteerInbox, consumeInterruptRequest, consumeSteerRequests, deliverInterruptRequest, deliverStopRequest, deliverTimeoutRequest, enqueueStepSteer, steerAcksDir, steerCapabilityPath, stepSteerInboxDir, watchAsyncControlInbox, type SteerAck, type SteerCapability, type SteerRequest, type StopRequest } from "./control-channel.ts";
15
15
  import { appendJsonl as appendRawJsonl, formatOutputArtifactContent, getArtifactPaths, writeArtifact, writeMetadata } from "../../shared/artifacts.ts";
16
16
  import { PI_CODING_AGENT_PACKAGE, getPiSpawnCommand, resolveInstalledPiPackageRoot } from "../shared/pi-spawn.ts";
17
17
  import { captureSingleOutputSnapshot, extractChildWrittenOutput, finalizeSingleOutput, formatSavedOutputReference, injectOutputPathSystemPrompt, injectSingleOutputInstruction, resolveSingleOutput, type SingleOutputSnapshot } from "../shared/single-output.ts";
@@ -48,6 +48,7 @@ import {
48
48
  type SteeringStatus,
49
49
  type SteeringTargetState,
50
50
  type SteeringTargetStatus,
51
+ type SubagentChildStatusEvent,
51
52
  DEFAULT_MAX_OUTPUT,
52
53
  type MaxOutputConfig,
53
54
  SUBAGENT_LIFECYCLE_ARTIFACT_VERSION,
@@ -79,13 +80,14 @@ import {
79
80
  import { applyThinkingSuffix, buildPiArgs, cleanupTempDir, projectLaunchResolvedChildExtensions, resolvePiLaunchToolPlan, type SubagentTaskDelivery } from "../shared/pi-args.ts";
80
81
  import { readRuntimeAcknowledgedExtensions } from "../shared/runtime-acknowledged-extensions.ts";
81
82
  import { outputEntryFromAsyncResult, resolveOutputReferences } from "../shared/chain-outputs.ts";
82
- import { createStructuredOutputRuntime, MISSING_STRUCTURED_OUTPUT_CALL_ERROR, readStructuredOutput } from "../shared/structured-output.ts";
83
+ import { createStructuredOutputRuntime, MISSING_STRUCTURED_OUTPUT_CALL_ERROR, readStructuredOutput, readStructuredOutputAcceptanceReport } from "../shared/structured-output.ts";
83
84
  import { formatProcessSignalError, isUnexplainedProcessSignal } from "../shared/process-signal.ts";
84
85
  import { readChildToolDiagnosticError } from "../shared/tool-availability.ts";
86
+ import { buildTimeoutRecoverySummary, collectTrackedMutationEvidence, snapshotTrackedMutations } from "../shared/mutation-evidence.ts";
85
87
  import { collectDynamicResults, DynamicFanoutError, materializeDynamicParallelStep, validateDynamicCollection } from "../shared/dynamic-fanout.ts";
86
88
  import { claimRunFanoutBatch, getRunFanoutBudgetSnapshot } from "../shared/run-fanout-budget.ts";
87
89
  import { nestedSummaryFromAsyncStatus, projectNestedEvents, resolveNestedAsyncDir, writeNestedEvent } from "../shared/nested-events.ts";
88
- import { formatModelAttemptNote, isRetryableModelFailure, recordRetryableModelFailure } from "../shared/model-fallback.ts";
90
+ import { formatModelAttemptNote, formatSubagentModelVerificationError, isContextOverflow, isRetryableModelFailure, recordRetryableModelFailure } from "../shared/model-fallback.ts";
89
91
  import {
90
92
  SUBAGENT_STARTUP_RETRY_DELAYS_MS,
91
93
  formatSubagentExtensionConflictError,
@@ -99,7 +101,7 @@ import { createOwnedProcessTreeController, type OwnedProcessTreeController } fro
99
101
  import { createSteeringStatus, recordSteeringRequest, steeringStatus, terminalSteeringNoticeState, updateSteeringTarget } from "./steering.ts";
100
102
  import { attachPostExitStdioGuard, trySignalChild } from "../../shared/post-exit-stdio-guard.ts";
101
103
  import { PROMPT_REDACTED, detectSubagentError, extractTextFromContent, extractToolArgsPreview, getFinalOutput, hasEmptyTerminalAssistantResponse, readStatus } from "../../shared/utils.ts";
102
- import { evaluateCompletionMutationGuard } from "../shared/completion-guard.ts";
104
+ import { evaluateCompletionMutationGuard, validateImplementationToolContract } from "../shared/completion-guard.ts";
103
105
  import {
104
106
  createMutatingFailureState,
105
107
  didMutatingToolFail,
@@ -123,13 +125,16 @@ import {
123
125
  type WorktreeSetup,
124
126
  } from "../shared/worktree.ts";
125
127
  import { resolveEffectiveThinking } from "../../shared/model-info.ts";
128
+ import { assertThinkingWithinCeiling, decodeThinkingCeiling, SUBAGENT_THINKING_CEILING_ENV } from "../../shared/thinking-ceiling.ts";
126
129
  import { launchBindingDigest } from "../../shared/launch-contract.ts";
127
130
  import { writeInitialProgressFile } from "../../shared/settings.ts";
128
131
  import { resolveSubagentIntercomTarget } from "../../intercom/intercom-bridge.ts";
129
132
  import { acceptanceFailureMessage, aggregateAcceptanceReport, buildSkippedAcceptanceLedger, evaluateAcceptance, formatAcceptancePrompt, resolveEffectiveAcceptance, stripAcceptanceReport } from "../shared/acceptance.ts";
130
133
  import { attachContractProjections, isAgentContractV1 } from "../shared/agent-contract.ts";
131
134
  import { waitForImportedAsyncRoot } from "./chain-root-attachment.ts";
135
+ import { normalizeExtensionBindings } from "../shared/extension-bindings.ts";
132
136
  import { appendRunnerStepsToStatus, consumeChainAppendRequests, countPendingChainAppendRequests, statusStepDescription } from "./chain-append.ts";
137
+ import { asyncStatusChildIdentity } from "../shared/child-identity.ts";
133
138
  import { appendTurnBudgetSystemPrompt, formatTurnBudgetOutput, initialTurnBudgetState, turnBudgetDecision, turnBudgetDeferredNote, turnBudgetDeferredState, turnBudgetExceededMessage, turnBudgetSoftNote, turnBudgetState } from "../shared/turn-budget.ts";
134
139
  import { initialToolBudgetState, toolBudgetState } from "../shared/tool-budget.ts";
135
140
  import { effectiveToolTimeoutMs, formatToolTimeoutMessage, toolTimeoutCallKey } from "../shared/tool-timeout.ts";
@@ -226,6 +231,7 @@ interface StepResult {
226
231
  timedOut?: boolean;
227
232
  stopped?: boolean;
228
233
  processSignal?: string | null;
234
+ timeoutRecovery?: import("../../shared/types.ts").TimeoutRecoverySummary;
229
235
  turnBudget?: TurnBudgetState;
230
236
  turnBudgetExceeded?: boolean;
231
237
  wrapUpRequested?: boolean;
@@ -236,6 +242,8 @@ interface StepResult {
236
242
  model?: string;
237
243
  attemptedModels?: string[];
238
244
  modelAttempts?: ModelAttempt[];
245
+ /** True when the dispatch failed because the input exceeded the model's context window. */
246
+ contextOverflow?: boolean;
239
247
  totalCost?: CostSummary;
240
248
  artifactPaths?: ArtifactPaths;
241
249
  outputSaveError?: string;
@@ -535,6 +543,9 @@ interface RunPiStreamingResult {
535
543
  processCloseObservedAt?: number;
536
544
  processSignal?: string | null;
537
545
  processTree: ProcessTreeTerminalV1;
546
+ currentTool?: string;
547
+ currentToolArgs?: string;
548
+ currentPath?: string;
538
549
  }
539
550
 
540
551
  function runPiStreaming(
@@ -558,6 +569,8 @@ function runPiStreaming(
558
569
  toolTimeoutMs?: number,
559
570
  runDeadlineAt?: number,
560
571
  orcaProgressTab?: OrcaProgressTab,
572
+ expectedModelForVerification?: string,
573
+ modelVerificationRegistry?: Array<{ provider: string; id: string; fullId: string }>,
561
574
  ): Promise<RunPiStreamingResult> {
562
575
  return new Promise((resolve) => {
563
576
  const startedAt = Date.now();
@@ -603,6 +616,9 @@ function runPiStreaming(
603
616
  let observedMutationAttempt = false;
604
617
  let structuredOutputToolInvoked = false;
605
618
  let structuredOutputMessageStartIndex: number | undefined;
619
+ let currentTool: string | undefined;
620
+ let currentToolArgs: string | undefined;
621
+ let currentPath: string | undefined;
606
622
  let toolCount = 0;
607
623
  const childWatchdogConfig = decodeChildWatchdogConfig(env?.[CHILD_WATCHDOG_CONFIG_ENV]);
608
624
  let childWatchdogState: ChildWatchdogStateSnapshot | undefined;
@@ -694,12 +710,18 @@ function runPiStreaming(
694
710
 
695
711
  if (event.type === "tool_execution_end") {
696
712
  clearActiveToolTimeout(event);
713
+ currentTool = undefined;
714
+ currentToolArgs = undefined;
715
+ currentPath = undefined;
697
716
  return;
698
717
  }
699
718
 
700
719
  if (event.type === "tool_execution_start" && event.toolName) {
701
720
  toolCount += 1;
702
721
  armToolTimeout({ toolCallId: (event as { toolCallId?: unknown }).toolCallId, toolName: event.toolName });
722
+ currentTool = event.toolName;
723
+ currentToolArgs = extractToolArgsPreview(event.args ?? {});
724
+ currentPath = resolveCurrentPath(event.toolName, event.args);
703
725
  if (event.toolName === "structured_output") {
704
726
  structuredOutputToolInvoked = true;
705
727
  structuredOutputMessageStartIndex = messages.length;
@@ -716,7 +738,14 @@ function runPiStreaming(
716
738
  if (text) writeOutputText(text);
717
739
 
718
740
  if (event.type !== "message_end" || event.message.role !== "assistant") return;
719
- if (event.message.model) model = event.message.model;
741
+ const hasToolCall = assistantStartsToolCall(event.message);
742
+ if (event.message.model) {
743
+ model = event.message.model;
744
+ if (expectedModelForVerification && !hasToolCall) {
745
+ const modelVerificationError = formatSubagentModelVerificationError(expectedModelForVerification, event.message.model, modelVerificationRegistry);
746
+ if (modelVerificationError && !error) error = modelVerificationError;
747
+ }
748
+ }
720
749
  if (event.message.errorMessage) assistantError = event.message.errorMessage;
721
750
  const eventUsage = event.message.usage;
722
751
  if (eventUsage) {
@@ -1015,6 +1044,9 @@ function runPiStreaming(
1015
1044
  processCloseObservedAt,
1016
1045
  processSignal: signal,
1017
1046
  processTree,
1047
+ currentTool,
1048
+ currentToolArgs,
1049
+ currentPath,
1018
1050
  }));
1019
1051
  });
1020
1052
 
@@ -1193,6 +1225,8 @@ interface SingleStepContext {
1193
1225
  onExternalProcess?: (process: ExternalProcessStatus) => void;
1194
1226
  onExternalJob?: (status: ExternalJobStatus) => void;
1195
1227
  skipAcceptance?: () => boolean;
1228
+ /** False when sibling work in the same Git worktree could have caused the tracked diff. */
1229
+ trackedMutationEvidenceForCompletionGuard?: boolean;
1196
1230
  orcaProgressTab?: OrcaProgressTab;
1197
1231
  }
1198
1232
 
@@ -1257,6 +1291,7 @@ async function runSingleStepInner(
1257
1291
  model: imported.model,
1258
1292
  attemptedModels: imported.attemptedModels,
1259
1293
  modelAttempts: imported.modelAttempts,
1294
+ contextOverflow: imported.contextOverflow,
1260
1295
  totalCost: imported.totalCost,
1261
1296
  structuredOutput: timedOut || stopped ? undefined : imported.structuredOutput,
1262
1297
  structuredOutputPath: timedOut || stopped ? undefined : imported.structuredOutputPath,
@@ -1276,8 +1311,48 @@ async function runSingleStepInner(
1276
1311
  let task = step.task.replace(placeholderRegex, () => ctx.previousOutput);
1277
1312
  if (ctx.outputs) task = resolveOutputReferences(task, ctx.outputs);
1278
1313
  const taskForCompletionGuard = task;
1314
+ let resolvedTaskToolPlan: ReturnType<typeof resolvePiLaunchToolPlan> | undefined;
1315
+ if (!step.runner) {
1316
+ resolvedTaskToolPlan = resolvePiLaunchToolPlan(omitUndefinedProperties({
1317
+ tools: step.tools,
1318
+ extensions: step.extensions,
1319
+ subagentOnlyExtensions: step.subagentOnlyExtensions,
1320
+ fast: step.fast,
1321
+ model: step.model,
1322
+ modelCandidates: step.modelCandidates,
1323
+ mcpDirectTools: step.mcpDirectTools,
1324
+ cwd: step.cwd ?? ctx.cwd,
1325
+ requireReadTool: Boolean(step.skills?.length),
1326
+ structuredOutput: Boolean(effectiveStructuredOutput),
1327
+ capabilityCeiling: step.capabilityCeiling ?? ctx.capabilityCeiling,
1328
+ inheritedCapabilityCeiling: decodeSubagentCapabilityCeiling(process.env[SUBAGENT_CAPABILITY_CEILING_ENV]),
1329
+ permissionRules: step.permissionRules,
1330
+ }));
1331
+ const contractTools = resolvedTaskToolPlan.explicitToolAllowlist ? resolvedTaskToolPlan.effectiveToolAllowlist : undefined;
1332
+ const contractError = validateImplementationToolContract({
1333
+ agent: step.agent,
1334
+ task: taskForCompletionGuard,
1335
+ tools: contractTools,
1336
+ mcpDirectTools: resolvedTaskToolPlan.effectiveMcpTools,
1337
+ configuredExtensions: resolvedTaskToolPlan.configuredExtensions,
1338
+ requestedTools: resolvedTaskToolPlan.requestedBuiltinTools,
1339
+ acceptanceRole: step.acceptanceRole,
1340
+ completionGuard: step.completionGuard,
1341
+ });
1342
+ if (contractError) {
1343
+ return omitUndefinedProperties({
1344
+ agent: step.agent,
1345
+ context: step.context,
1346
+ output: contractError,
1347
+ error: contractError,
1348
+ exitCode: 1,
1349
+ capabilityCeiling: resolvedTaskToolPlan.capabilityCeiling,
1350
+ capabilityAudit: resolvedTaskToolPlan.capabilityAudit,
1351
+ });
1352
+ }
1353
+ }
1279
1354
  if (step.effectiveAcceptance) {
1280
- const acceptancePrompt = formatAcceptancePrompt(step.effectiveAcceptance, { reportOptional: isAgentContractV1(step.agentContract) });
1355
+ const acceptancePrompt = formatAcceptancePrompt(step.effectiveAcceptance, { reportOptional: isAgentContractV1(step.agentContract), structuredOutput: Boolean(step.structuredOutput?.acceptanceReportPath) });
1281
1356
  if (acceptancePrompt) task = `${task}\n${acceptancePrompt}`;
1282
1357
  }
1283
1358
  const sessionEnabled = Boolean(step.sessionFile) || ctx.sessionEnabled;
@@ -1392,6 +1467,7 @@ async function runSingleStepInner(
1392
1467
  timeoutMessage: ctx.timeoutMessage,
1393
1468
  stopMessage: ctx.stopMessage,
1394
1469
  onExternalJob: ctx.onExternalJob,
1470
+ followUp: step.externalJobFollowUp,
1395
1471
  }));
1396
1472
  try { fs.writeFileSync(ctx.outputFile, external.output, "utf-8"); } catch { /* Observability output is best-effort. */ }
1397
1473
  const resolvedOutput = step.outputPath && external.exitCode === 0
@@ -1447,20 +1523,33 @@ async function runSingleStepInner(
1447
1523
  const eventsPath = path.join(path.dirname(ctx.outputFile), "events.jsonl");
1448
1524
  let finalResult: RunPiStreamingResult | undefined;
1449
1525
  let finalOutputSnapshot: SingleOutputSnapshot | undefined;
1526
+ let structuredAcceptanceReport: unknown;
1527
+ let structuredAcceptanceReportError: string | undefined;
1450
1528
  let completionGuardTriggeredFinal = false;
1451
1529
  let turnBudget = ctx.turnBudget ? initialTurnBudgetState(ctx.turnBudget) : undefined;
1452
1530
  let toolBudget = step.toolBudget ? initialToolBudgetState(step.toolBudget) : undefined;
1453
1531
  let toolBudgetBlocked = false;
1454
1532
  let actualLaunchContractDigest = step.launchContractDigest;
1533
+ const mutationSnapshot = snapshotTrackedMutations(step.cwd ?? ctx.cwd);
1534
+ let finalMutationEvidence = collectTrackedMutationEvidence(mutationSnapshot, step.cwd ?? ctx.cwd);
1455
1535
 
1456
1536
  let modelIndex = 0;
1457
1537
  let startupAttemptIndex = 0;
1458
1538
  // Escalated to "file" after an unexplained zero-activity startup failure so
1459
1539
  // retries keep the task text out of argv (endpoint pre-exec scans may deny it).
1460
1540
  let taskDeliveryOverride: SubagentTaskDelivery | undefined;
1541
+ let contextOverflow = false;
1542
+ let launchWarningsEmitted = false;
1461
1543
  modelAttemptsLoop: while (modelIndex < candidates.length) {
1462
1544
  if (ctx.timeoutSignal?.aborted || ctx.stopSignal?.aborted || ctx.skipAcceptance?.()) break;
1463
1545
  const candidate = candidates[modelIndex];
1546
+ const expectedModelForVerification = candidate && !(step.skipPrimaryModelVerification && modelIndex === 0) ? candidate : undefined;
1547
+ try {
1548
+ assertThinkingWithinCeiling({ model: candidate, configThinking: step.thinking, ceiling: step.thinkingCeiling ?? decodeThinkingCeiling(process.env[SUBAGENT_THINKING_CEILING_ENV]), agent: step.agent, runId: ctx.id });
1549
+ } catch (error) {
1550
+ const message = error instanceof Error ? error.message : String(error);
1551
+ return omitUndefinedProperties({ agent: step.agent, output: message, error: message, exitCode: 1, context: step.context, thinkingCeiling: step.thinkingCeiling });
1552
+ }
1464
1553
  ctx.onAttemptStart?.(omitUndefinedProperties({ model: candidate, thinking: resolveEffectiveThinking(candidate, step.thinking) }));
1465
1554
  const outputSnapshot = captureSingleOutputSnapshot(step.outputPath);
1466
1555
  if (effectiveStructuredOutput) {
@@ -1471,6 +1560,7 @@ async function runSingleStepInner(
1471
1560
  }
1472
1561
  }
1473
1562
  const watchdogConfig = resolveWatchdogConfig(step.cwd ?? ctx.cwd);
1563
+ const extensionBindings = normalizeExtensionBindings(step.extensionBindings)?.value;
1474
1564
  const childWatchdog = watchdogConfig.ok
1475
1565
  ? resolveChildWatchdogConfig({
1476
1566
  config: watchdogConfig.config,
@@ -1479,7 +1569,7 @@ async function runSingleStepInner(
1479
1569
  childIndex: ctx.flatIndex,
1480
1570
  })
1481
1571
  : undefined;
1482
- const { args, env, tempDir, toolDiagnosticPath, runtimeAcknowledgedExtensionsPath, capabilityAudit: attemptCapabilityAudit } = buildPiArgs(omitUndefinedProperties({
1572
+ const { args, env, tempDir, toolDiagnosticPath, runtimeAcknowledgedExtensionsPath, capabilityAudit: attemptCapabilityAudit, warnings } = buildPiArgs(omitUndefinedProperties({
1483
1573
  parentSessionId: step.parentSessionId,
1484
1574
  baseArgs: ["--mode", "json", "-p"],
1485
1575
  task,
@@ -1494,6 +1584,8 @@ async function runSingleStepInner(
1494
1584
  tools: step.tools,
1495
1585
  extensions: step.extensions,
1496
1586
  subagentOnlyExtensions: step.subagentOnlyExtensions,
1587
+ fast: step.fast,
1588
+ modelCandidates: step.modelCandidates,
1497
1589
  systemPrompt: appendTurnBudgetSystemPrompt(step.systemPrompt ?? "", ctx.turnBudget),
1498
1590
  systemPromptMode: step.systemPromptMode,
1499
1591
  mcpDirectTools: step.mcpDirectTools,
@@ -1524,18 +1616,28 @@ async function runSingleStepInner(
1524
1616
  : undefined,
1525
1617
  childWatchdog,
1526
1618
  waitToolEnabled: step.waitToolEnabled,
1619
+ thinkingCeiling: step.thinkingCeiling,
1620
+ extensionBindings,
1527
1621
  }));
1622
+ if (!launchWarningsEmitted && warnings.length > 0) {
1623
+ for (const warning of warnings) console.warn(`[pi-subagents] ${warning}`);
1624
+ launchWarningsEmitted = true;
1625
+ }
1528
1626
  if (step.definitionDigest) {
1529
- const toolPlan = resolvePiLaunchToolPlan(omitUndefinedProperties({
1627
+ const toolPlan = resolvedTaskToolPlan ?? resolvePiLaunchToolPlan(omitUndefinedProperties({
1530
1628
  tools: step.tools,
1531
1629
  extensions: step.extensions,
1532
1630
  subagentOnlyExtensions: step.subagentOnlyExtensions,
1631
+ fast: step.fast,
1632
+ model: step.model,
1633
+ modelCandidates: step.modelCandidates,
1533
1634
  mcpDirectTools: step.mcpDirectTools,
1534
1635
  cwd: step.cwd ?? ctx.cwd,
1535
1636
  requireReadTool: Boolean(step.skills?.length),
1536
1637
  structuredOutput: Boolean(effectiveStructuredOutput),
1537
1638
  capabilityCeiling: step.capabilityCeiling ?? ctx.capabilityCeiling,
1538
1639
  inheritedCapabilityCeiling: decodeSubagentCapabilityCeiling(process.env[SUBAGENT_CAPABILITY_CEILING_ENV]),
1640
+ permissionRules: step.permissionRules,
1539
1641
  }));
1540
1642
  launchResolvedExtensions = projectLaunchResolvedChildExtensions(toolPlan);
1541
1643
  actualLaunchContractDigest = launchBindingDigest(omitUndefinedProperties({
@@ -1543,7 +1645,9 @@ async function runSingleStepInner(
1543
1645
  task: step.launchBindingTask ?? task,
1544
1646
  ...(candidate ? { model: candidate } : {}),
1545
1647
  modelCandidates: candidates as string[],
1648
+ ...(step.fast !== undefined ? { fast: step.fast } : {}),
1546
1649
  ...(resolveEffectiveThinking(candidate, step.thinking) ? { thinking: resolveEffectiveThinking(candidate, step.thinking) } : {}),
1650
+ ...(step.thinkingCeiling ? { thinkingCeiling: step.thinkingCeiling } : {}),
1547
1651
  systemPrompt: appendTurnBudgetSystemPrompt(step.systemPrompt ?? "", ctx.turnBudget),
1548
1652
  systemPromptMode: step.systemPromptMode,
1549
1653
  inheritProjectContext: step.inheritProjectContext,
@@ -1555,6 +1659,7 @@ async function runSingleStepInner(
1555
1659
  ...(step.outputPath ? { outputPath: step.outputPath } : {}),
1556
1660
  ...(step.outputMode ? { outputMode: step.outputMode } : {}),
1557
1661
  ...(step.structuredOutputSchema ? { structuredOutputSchema: step.structuredOutputSchema } : {}),
1662
+ ...(extensionBindings ? { extensionBindings } : {}),
1558
1663
  }));
1559
1664
  }
1560
1665
  capabilityAudit = attemptCapabilityAudit;
@@ -1580,6 +1685,8 @@ async function runSingleStepInner(
1580
1685
  ctx.toolTimeoutMs,
1581
1686
  ctx.deadlineAt,
1582
1687
  ctx.orcaProgressTab,
1688
+ expectedModelForVerification,
1689
+ step.modelVerificationRegistry,
1583
1690
  );
1584
1691
  if (run.processCloseObservedAt !== undefined) {
1585
1692
  writerProcesses.push({
@@ -1632,6 +1739,9 @@ async function runSingleStepInner(
1632
1739
  if (structured.error) structuredError = structured.error;
1633
1740
  else {
1634
1741
  structuredOutput = structured.value;
1742
+ const acceptanceReport = readStructuredOutputAcceptanceReport(effectiveStructuredOutput);
1743
+ structuredAcceptanceReport = acceptanceReport.value;
1744
+ structuredAcceptanceReportError = acceptanceReport.error;
1635
1745
  validatedStructuredOutput = true;
1636
1746
  }
1637
1747
  }
@@ -1652,21 +1762,31 @@ async function runSingleStepInner(
1652
1762
  ? "Subagent produced no output (possible model cold-start or empty response)."
1653
1763
  : undefined;
1654
1764
  const completionGuardEnabled = isAgentContractV1(step.agentContract) ? step.completionGuard === true : step.completionGuard !== false;
1655
- const completionGuard = run.exitCode === 0 && !run.error && !toolAvailabilityError && !structuredError && !hiddenError?.hasError && !emptyOutputError && completionGuardEnabled
1765
+ const completionToolPlan = resolvedTaskToolPlan;
1766
+ const mutationEvidence = collectTrackedMutationEvidence(mutationSnapshot, step.cwd ?? ctx.cwd);
1767
+ finalMutationEvidence = mutationEvidence;
1768
+ const completionMutationEvidence = ctx.trackedMutationEvidenceForCompletionGuard === false ? undefined : mutationEvidence;
1769
+ const completionGuard = run.exitCode === 0 && !run.error && !structuredError && !hiddenError?.hasError && !emptyOutputError && completionGuardEnabled
1656
1770
  ? evaluateCompletionMutationGuard(omitUndefinedProperties({
1657
1771
  agent: step.agent,
1658
1772
  task: taskForCompletionGuard,
1659
1773
  messages: run.messages,
1660
- tools: step.tools,
1661
- mcpDirectTools: step.mcpDirectTools,
1774
+ tools: completionToolPlan ? (completionToolPlan.explicitToolAllowlist ? completionToolPlan.effectiveToolAllowlist : undefined) : step.tools,
1775
+ mcpDirectTools: completionToolPlan?.effectiveMcpTools ?? step.mcpDirectTools,
1776
+ toolAvailabilityError,
1777
+ mutationEvidence: completionMutationEvidence,
1662
1778
  }))
1663
1779
  : undefined;
1664
- const completionGuardTriggered = completionGuard?.triggered === true && !run.observedMutationAttempt;
1780
+ const mutationAttemptObserved = run.observedMutationAttempt === true || completionMutationEvidence?.attemptedMutation === true;
1781
+ const completionGuardTriggered = completionGuard?.triggered === true && !mutationAttemptObserved;
1782
+ const completionGuardBlocked = completionGuard?.blocked === true;
1665
1783
  const fileMutationEffect = completionGuard
1666
1784
  ? {
1667
- status: completionGuard.expectedMutation ? completionGuardTriggered ? "missing" as const : "observed" as const : "not-applicable" as const,
1785
+ status: completionGuardBlocked ? "blocked" as const : completionGuard.expectedMutation ? completionGuardTriggered ? "missing" as const : "observed" as const : "not-applicable" as const,
1668
1786
  expected: completionGuard.expectedMutation,
1669
- attempted: completionGuard.attemptedMutation || run.observedMutationAttempt === true,
1787
+ attempted: completionGuardBlocked ? false : completionGuard.attemptedMutation || mutationAttemptObserved,
1788
+ ...(completionMutationEvidence ? { evidence: completionMutationEvidence } : {}),
1789
+ ...(completionGuardBlocked && completionGuard.message ? { message: completionGuard.message } : {}),
1670
1790
  ...(completionGuardTriggered ? { message: "Subagent completed without making edits for an implementation task." } : {}),
1671
1791
  }
1672
1792
  : undefined;
@@ -1771,6 +1891,11 @@ async function runSingleStepInner(
1771
1891
  }
1772
1892
  const retryableModelFailure = isRetryableModelFailure(error);
1773
1893
  if (retryableModelFailure) recordRetryableModelFailure(candidate ?? run.model ?? step.model, error);
1894
+ if (isContextOverflow(error)) {
1895
+ contextOverflow = true;
1896
+ attemptNotes.push(`[fallback] ${attempt.model} failed: context overflow — the input exceeds this model's context window. Reduce the task input or use a model with a larger context window.`);
1897
+ break modelAttemptsLoop;
1898
+ }
1774
1899
  if (!retryableModelFailure || modelIndex === candidates.length - 1) break modelAttemptsLoop;
1775
1900
  attemptNotes.push(formatModelAttemptNote(attempt, candidates[modelIndex + 1]));
1776
1901
  modelIndex += 1;
@@ -1810,6 +1935,21 @@ async function runSingleStepInner(
1810
1935
  : resolvedOutput.savedPath
1811
1936
  ? "unknown"
1812
1937
  : finalResult?.outputState ?? "unknown";
1938
+ const timeoutRecovery = finalResult?.timedOut === true || ctx.timeoutSignal?.aborted === true
1939
+ ? buildTimeoutRecoverySummary({
1940
+ termination: "timed-out",
1941
+ evidence: finalMutationEvidence,
1942
+ currentTool: finalResult?.currentTool,
1943
+ currentToolArgs: finalResult?.currentToolArgs,
1944
+ currentPath: finalResult?.currentPath,
1945
+ sessionFile: step.sessionFile,
1946
+ transcriptPath: transcriptWriter ? artifactPaths?.transcriptPath : undefined,
1947
+ artifactPaths,
1948
+ })
1949
+ : undefined;
1950
+ if (timeoutRecovery) outputForSummary = outputForSummary.trim()
1951
+ ? `${outputForSummary}\n\n${timeoutRecovery.message}`
1952
+ : timeoutRecovery.message;
1813
1953
  const finalizedOutput = finalizeSingleOutput(omitUndefinedProperties({
1814
1954
  fullOutput: outputForSummary,
1815
1955
  outputPath: step.outputPath,
@@ -1824,6 +1964,8 @@ async function runSingleStepInner(
1824
1964
  ? await evaluateAcceptance(omitUndefinedProperties({
1825
1965
  acceptance: step.effectiveAcceptance,
1826
1966
  output: outputForAcceptance,
1967
+ report: structuredAcceptanceReport as import("../../shared/types.ts").AcceptanceReport | undefined,
1968
+ reportError: structuredAcceptanceReportError,
1827
1969
  fileOutput: childWrittenOutput !== undefined && step.outputPath
1828
1970
  ? { content: childWrittenOutput, path: step.outputPath, authoritative: step.outputMode === "file-only" }
1829
1971
  : undefined,
@@ -1908,6 +2050,7 @@ async function runSingleStepInner(
1908
2050
  model: finalResult?.model,
1909
2051
  attemptedModels: attemptedModels.length > 0 ? attemptedModels : undefined,
1910
2052
  modelAttempts,
2053
+ contextOverflow: contextOverflow || undefined,
1911
2054
  totalCost: costSummaryFromAttempts(modelAttempts),
1912
2055
  artifactPaths,
1913
2056
  outputSaveError: artifactErrors.outputSaveError,
@@ -1918,6 +2061,7 @@ async function runSingleStepInner(
1918
2061
  timedOut: timedOutAfterAcceptance ? true : finalResult?.timedOut,
1919
2062
  stopped: stoppedAfterAcceptance ? true : finalResult?.stopped,
1920
2063
  processSignal: finalResult?.processSignal,
2064
+ timeoutRecovery,
1921
2065
  turnBudget,
1922
2066
  turnBudgetExceeded: turnBudgetExceeded || undefined,
1923
2067
  wrapUpRequested: finalResult?.wrapUpRequested || turnBudget?.outcome === "wrap-up-requested" || turnBudget?.outcome === "termination-deferred" || turnBudgetExceeded || undefined,
@@ -1943,21 +2087,8 @@ async function runSingleStep(
1943
2087
  step: SubagentStep,
1944
2088
  ctx: SingleStepContext,
1945
2089
  ): Promise<StepResult & { completionGuardTriggered?: boolean }> {
1946
- if (step.importAsyncRoot) return runSingleStepInner(step, ctx);
1947
- const orcaProgressTab = createOrcaProgressTab({
1948
- cwd: step.cwd ?? ctx.cwd,
1949
- runId: ctx.id,
1950
- agent: step.agent,
1951
- index: ctx.flatIndex,
1952
- });
1953
- try {
1954
- const result = await runSingleStepInner(step, { ...ctx, orcaProgressTab });
1955
- orcaProgressTab?.finish(result.stopped ? "stopped" : result.exitCode === 0 && !result.error ? "completed" : "failed", result.sessionFile);
1956
- return result;
1957
- } catch (error) {
1958
- orcaProgressTab?.finish("failed");
1959
- throw error;
1960
- }
2090
+ if (!step.importAsyncRoot) ctx.orcaProgressTab?.section({ agent: step.agent, index: ctx.flatIndex, count: ctx.flatStepCount });
2091
+ return runSingleStepInner(step, ctx);
1961
2092
  }
1962
2093
 
1963
2094
  type RunnerStatusStep = NonNullable<AsyncStatus["steps"]>[number] & {
@@ -2226,6 +2357,7 @@ async function runSubagent(
2226
2357
  const activeChildInterrupts = new Map<number, () => void>();
2227
2358
  const activeChildTimeouts = new Map<number, () => void>();
2228
2359
  const activeChildStops = new Map<number, () => void>();
2360
+ const childStopRequests = new Map<number, { childId: string; requestedAt: number }>();
2229
2361
  const activeChildTurnBudgetAborts = new Map<number, (message: string, state?: TurnBudgetState) => void>();
2230
2362
  const pendingStepSteers: SteerRequest[] = [];
2231
2363
  const steeringCapabilities = new Map<number, SteerCapability>();
@@ -2269,6 +2401,7 @@ async function runSubagent(
2269
2401
  ...(task.launchContractDigest ? { launchContractDigest: task.launchContractDigest } : {}),
2270
2402
  ...(task.launchResolvedExtensions ? { launchResolvedExtensions: task.launchResolvedExtensions } : {}),
2271
2403
  ...(task.capabilityCeiling ? { capabilityCeiling: task.capabilityCeiling } : {}),
2404
+ ...(task.thinkingCeiling ? { thinkingCeiling: task.thinkingCeiling } : {}),
2272
2405
  status: "pending",
2273
2406
  ...(task.toolBudget ? { toolBudget: initialToolBudgetState(task.toolBudget) } : {}),
2274
2407
  ...(task.sessionFile ? { sessionFile: task.sessionFile } : {}),
@@ -2294,6 +2427,7 @@ async function runSubagent(
2294
2427
  structured: Boolean(step.collect.outputSchema),
2295
2428
  ...(step.agentContract ? { agentContract: step.agentContract } : {}),
2296
2429
  ...(step.capabilityCeiling ? { capabilityCeiling: step.capabilityCeiling } : {}),
2430
+ ...(step.thinkingCeiling ? { thinkingCeiling: step.thinkingCeiling } : {}),
2297
2431
  status: "pending",
2298
2432
  ...(step.parallel.toolBudget ? { toolBudget: initialToolBudgetState(step.parallel.toolBudget) } : {}),
2299
2433
  recentTools: [],
@@ -2316,6 +2450,7 @@ async function runSubagent(
2316
2450
  ...(step.launchContractDigest ? { launchContractDigest: step.launchContractDigest } : {}),
2317
2451
  ...(step.launchResolvedExtensions ? { launchResolvedExtensions: step.launchResolvedExtensions } : {}),
2318
2452
  ...(step.capabilityCeiling ? { capabilityCeiling: step.capabilityCeiling } : {}),
2453
+ ...(step.thinkingCeiling ? { thinkingCeiling: step.thinkingCeiling } : {}),
2319
2454
  status: "pending",
2320
2455
  ...(step.toolBudget ? { toolBudget: initialToolBudgetState(step.toolBudget) } : {}),
2321
2456
  ...(step.sessionFile ? { sessionFile: step.sessionFile } : {}),
@@ -2338,6 +2473,19 @@ async function runSubagent(
2338
2473
  step.processTerminal = { version: 1, state: "pending", runId: id, runnerProcessInstanceId: config.runnerProcessInstanceId };
2339
2474
  }
2340
2475
  }
2476
+ const initialAgentLabel = initialStatusSteps.length === 1
2477
+ ? initialStatusSteps[0]!.agent
2478
+ : (config.resultMode ?? (flatSteps.length > 1 ? "chain" : "single")) === "parallel"
2479
+ ? `parallel:${initialStatusSteps.map((step) => step.agent).join("+")}`
2480
+ : `chain:${initialStatusSteps.map((step) => step.agent).join("->")}`;
2481
+ const orcaProgressTab = flatSteps.every((step) => step.importAsyncRoot) ? undefined : createOrcaProgressTab({
2482
+ cwd,
2483
+ runId: id,
2484
+ agent: initialAgentLabel,
2485
+ index: 0,
2486
+ stepCount: Math.max(initialStatusSteps.length, 1),
2487
+ });
2488
+
2341
2489
  const statusPayload: RunnerStatusPayload = omitUndefinedProperties({
2342
2490
  lifecycleArtifactVersion: SUBAGENT_LIFECYCLE_ARTIFACT_VERSION,
2343
2491
  runId: id,
@@ -2520,6 +2668,7 @@ async function runSubagent(
2520
2668
  model: step.model,
2521
2669
  attemptedModels: step.attemptedModels,
2522
2670
  modelAttempts: step.modelAttempts,
2671
+ contextOverflow: step.contextOverflow,
2523
2672
  })),
2524
2673
  exitCode: state === "complete" || state === "paused" ? 0 : 1,
2525
2674
  timestamp: now,
@@ -2555,6 +2704,83 @@ async function runSubagent(
2555
2704
  statusPayload.lastUpdate = Date.now();
2556
2705
  writeStatusPayload();
2557
2706
  };
2707
+ const childStopTargetId = (index: number): string => asyncStatusChildIdentity(requiredStatusStep(statusPayload, index), index);
2708
+ const appendChildStatusEvent = (index: number, childId: string, status: "stopping" | "stopped", now = Date.now()): void => {
2709
+ const step = requiredStatusStep(statusPayload, index);
2710
+ appendJsonl(eventsPath, JSON.stringify({
2711
+ type: "subagent.child-status",
2712
+ version: 1,
2713
+ ts: now,
2714
+ runId: id,
2715
+ childId,
2716
+ status,
2717
+ reason: "user",
2718
+ source: "async",
2719
+ stepIndex: index,
2720
+ agent: step.agent,
2721
+ ...(step.runId ? { childRunId: step.runId } : {}),
2722
+ ...(step.workflowKey ? { workflowKey: step.workflowKey } : {}),
2723
+ ...(step.phase ? { phase: step.phase } : {}),
2724
+ ...(step.label ? { label: step.label } : {}),
2725
+ } satisfies SubagentChildStatusEvent));
2726
+ };
2727
+ const appendTerminalChildStatusEvent = (index: number, now = Date.now()): void => {
2728
+ const request = childStopRequests.get(index);
2729
+ if (request) appendChildStatusEvent(index, request.childId, "stopped", now);
2730
+ };
2731
+ const markChildStopRequested = (index: number, childId: string, now = Date.now()): boolean => {
2732
+ const step = statusPayload.steps[index];
2733
+ if (!step || (step.status !== "pending" && step.status !== "running")) return false;
2734
+ childStopRequests.set(index, { childId, requestedAt: now });
2735
+ step.stopRequested = true;
2736
+ step.stopRequestedAt = now;
2737
+ delete step.activityState;
2738
+ statusPayload.lastUpdate = now;
2739
+ writeStatusPayload();
2740
+ appendJsonl(eventsPath, JSON.stringify({ type: "subagent.step.stop_requested", ts: now, runId: id, stepIndex: index, childId, agent: step.agent }));
2741
+ appendChildStatusEvent(index, childId, "stopping", now);
2742
+ return true;
2743
+ };
2744
+ const markChildStopped = (index: number, now = Date.now()): void => {
2745
+ const step = requiredStatusStep(statusPayload, index);
2746
+ if (step.status === "stopped") return;
2747
+ step.status = "stopped";
2748
+ step.error = stopMessage;
2749
+ step.exitCode = 1;
2750
+ step.stopped = true;
2751
+ step.stopRequested = true;
2752
+ step.stopRequestedAt = childStopRequests.get(index)?.requestedAt ?? step.stopRequestedAt ?? now;
2753
+ delete step.activityState;
2754
+ step.endedAt = now;
2755
+ step.durationMs = step.startedAt ? now - step.startedAt : 0;
2756
+ step.lastActivityAt = now;
2757
+ statusPayload.lastUpdate = now;
2758
+ writeStatusPayload();
2759
+ const childId = childStopRequests.get(index)?.childId ?? childStopTargetId(index);
2760
+ appendJsonl(eventsPath, JSON.stringify({ type: "subagent.step.stopped", ts: now, runId: id, stepIndex: index, childId, agent: step.agent, exitCode: 1, durationMs: step.durationMs }));
2761
+ appendChildStatusEvent(index, childId, "stopped", now);
2762
+ };
2763
+ const childStopResult = (index: number, agent: string, context?: "fresh" | "fork"): SingleStepResult => {
2764
+ markChildStopped(index);
2765
+ return stoppedStepResult(agent, context);
2766
+ };
2767
+ const stopChildStep = (request: StopRequest): void => {
2768
+ if (request.targetIndex === undefined) {
2769
+ stopRunner();
2770
+ return;
2771
+ }
2772
+ const childId = request.childId ?? childStopTargetId(request.targetIndex);
2773
+ const now = Date.now();
2774
+ if (!markChildStopRequested(request.targetIndex, childId, now)) {
2775
+ appendJsonl(eventsPath, JSON.stringify({ type: "subagent.step.stop_failed", ts: now, runId: id, stepIndex: request.targetIndex, childId, message: "Child is not pending or running." }));
2776
+ return;
2777
+ }
2778
+ const stop = activeChildStops.get(request.targetIndex);
2779
+ if (stop) stop();
2780
+ else if (requiredStatusStep(statusPayload, request.targetIndex).status === "pending") {
2781
+ appendJsonl(eventsPath, JSON.stringify({ type: "subagent.step.stop_queued", ts: now, runId: id, stepIndex: request.targetIndex, childId }));
2782
+ }
2783
+ };
2558
2784
  const registerStepInterrupt = (flatIndex: number, interrupt: (() => void) | undefined): void => {
2559
2785
  if (!interrupt) {
2560
2786
  activeChildInterrupts.delete(flatIndex);
@@ -2577,7 +2803,7 @@ async function runSubagent(
2577
2803
  return;
2578
2804
  }
2579
2805
  activeChildStops.set(flatIndex, stop);
2580
- if (stopped) stop();
2806
+ if (stopped || childStopRequests.has(flatIndex)) stop();
2581
2807
  };
2582
2808
  const registerStepTurnBudgetAbort = (flatIndex: number, abort: ((message: string, state?: TurnBudgetState) => void) | undefined): void => {
2583
2809
  if (!abort) {
@@ -3482,7 +3708,7 @@ async function runSubagent(
3482
3708
  const disposeControlInbox = watchAsyncControlInbox(asyncDir, {
3483
3709
  onInterrupt: interruptRunner,
3484
3710
  onTimeout: timeoutRunner,
3485
- onStop: stopRunner,
3711
+ onStop: stopChildStep,
3486
3712
  onSteer: (request) => {
3487
3713
  const targetStep = request.targetIndex !== undefined ? statusPayload.steps[request.targetIndex] : undefined;
3488
3714
  if (targetStep?.status === "pending") {
@@ -3558,6 +3784,19 @@ async function runSubagent(
3558
3784
  if (materialized.parallel.length > 1 && step.parallel.outputPath && !step.parallel.namespaceOutputPath) {
3559
3785
  throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} materialized ${materialized.parallel.length} items that resolve output to the same path: ${step.parallel.outputPath}. Remove the explicit output path or use an inherited relative agent output so each item can be isolated.`);
3560
3786
  }
3787
+ for (const [itemIndex] of materialized.parallel.entries()) {
3788
+ const thinkingOverride = step.thinkingOverrides?.[itemIndex];
3789
+ const model = thinkingOverride ? applyThinkingSuffix(step.parallel.model, thinkingOverride, true) : step.parallel.model;
3790
+ const configThinking = thinkingOverride ? thinkingOverride : step.parallel.thinking;
3791
+ const candidates = step.parallel.modelCandidates !== undefined
3792
+ ? step.parallel.modelCandidates.length > 0
3793
+ ? step.parallel.modelCandidates.map((candidate) => thinkingOverride ? applyThinkingSuffix(candidate, thinkingOverride, true) ?? candidate : candidate)
3794
+ : [undefined]
3795
+ : model ? [model] : [undefined];
3796
+ for (const candidate of candidates) {
3797
+ assertThinkingWithinCeiling({ model: candidate, configThinking, ceiling: step.parallel.thinkingCeiling ?? decodeThinkingCeiling(process.env[SUBAGENT_THINKING_CEILING_ENV]), agent: step.parallel.agent, runId: id });
3798
+ }
3799
+ }
3561
3800
  if (materialized.collectedOnEmpty) await validateDynamicCollection(step.collect.outputSchema, materialized.collectedOnEmpty);
3562
3801
  if (!config.runFanoutBudget) throw new Error("Async runner is missing its run fan-out budget identity.");
3563
3802
  const runFanoutBudget = claimRunFanoutBatch(config.runFanoutBudget, materialized.parallel.map((_, itemIndex) => `chain[${stepIndex}].expand[${itemIndex}]`));
@@ -3714,6 +3953,7 @@ async function runSubagent(
3714
3953
  ...(task.skills ? { skills: task.skills } : {}),
3715
3954
  ...(task.model ? { model: task.model } : {}),
3716
3955
  ...(task.thinking ? { thinking: task.thinking } : {}),
3956
+ ...(task.thinkingCeiling ? { thinkingCeiling: task.thinkingCeiling } : {}),
3717
3957
  ...(task.modelCandidates && task.modelCandidates.length > 0 ? { attemptedModels: task.modelCandidates } : task.model ? { attemptedModels: [task.model] } : {}),
3718
3958
  recentTools: [],
3719
3959
  recentOutput: [],
@@ -3785,6 +4025,7 @@ async function runSubagent(
3785
4025
  }
3786
4026
  if (timedOut) return timedOutStepResult(task.agent, task.context);
3787
4027
  if (stopped) return stoppedStepResult(task.agent, task.context);
4028
+ if (childStopRequests.has(fi)) return childStopResult(fi, task.agent, task.context);
3788
4029
  if (interrupted) return pausedStepResult(task.agent, task.context);
3789
4030
  if (aborted && failFast) {
3790
4031
  const skippedAt = Date.now();
@@ -3835,6 +4076,7 @@ async function runSubagent(
3835
4076
  registerTurnBudgetAbort: (abort) => registerStepTurnBudgetAbort(fi, abort),
3836
4077
  timeoutSignal: timeoutAbortController.signal,
3837
4078
  stopSignal: stopAbortController.signal,
4079
+ trackedMutationEvidenceForCompletionGuard: false,
3838
4080
  timeoutMessage,
3839
4081
  stopMessage,
3840
4082
  turnBudget: config.turnBudget,
@@ -3844,7 +4086,8 @@ async function runSubagent(
3844
4086
  onWriterProcess,
3845
4087
  onExternalProcess: (process) => updateExternalProcess(fi, process),
3846
4088
  onExternalJob: (externalJob) => updateExternalJob(fi, externalJob),
3847
- skipAcceptance: () => timedOut || stopped,
4089
+ skipAcceptance: () => timedOut || stopped || childStopRequests.has(fi),
4090
+ orcaProgressTab,
3848
4091
  }), config.deadlineAt);
3849
4092
  const taskEndTime = Date.now();
3850
4093
  const childInterrupted = singleResult.interrupted === true;
@@ -3869,6 +4112,7 @@ async function runSubagent(
3869
4112
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "thinking", resolveEffectiveThinking(singleResult.model, requiredStatusStep(statusPayload, fi).thinking));
3870
4113
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "attemptedModels", singleResult.attemptedModels);
3871
4114
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "modelAttempts", singleResult.modelAttempts);
4115
+ setOptionalProperty(requiredStatusStep(statusPayload, fi), "contextOverflow", singleResult.contextOverflow);
3872
4116
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "totalCost", singleResult.totalCost);
3873
4117
  if (singleResult.totalCost) {
3874
4118
  pendingParallelUsageCost = {
@@ -3892,6 +4136,7 @@ async function runSubagent(
3892
4136
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "structuredOutputPath", singleResult.structuredOutputPath);
3893
4137
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "structuredOutputSchemaPath", singleResult.structuredOutputSchemaPath);
3894
4138
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "acceptance", singleResult.acceptance);
4139
+ setOptionalProperty(requiredStatusStep(statusPayload, fi), "timeoutRecovery", singleResult.timeoutRecovery);
3895
4140
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "watchdog", singleResult.watchdog);
3896
4141
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "capabilityCeiling", singleResult.capabilityCeiling);
3897
4142
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "capabilityAudit", singleResult.capabilityAudit);
@@ -3900,13 +4145,14 @@ async function runSubagent(
3900
4145
  statusPayload.lastUpdate = taskEndTime;
3901
4146
  writeStatusPayload();
3902
4147
  appendCapabilityCeilingAppliedEvent(eventsPath, id, fi, task.agent, singleResult);
3903
- appendJsonl(eventsPath, JSON.stringify({
3904
- type: stopped || childStopped ? "subagent.step.stopped" : timedOut ? "subagent.step.failed" : childInterrupted ? "subagent.step.paused" : singleResult.exitCode === 0 ? "subagent.step.completed" : "subagent.step.failed",
3905
- ts: taskEndTime, runId: id, stepIndex: fi, agent: task.agent,
3906
- exitCode: stopped || childStopped ? 1 : timedOut ? 1 : childInterrupted ? 0 : singleResult.exitCode, durationMs: taskEndTime - taskStartTime,
3907
- }));
3908
- if (singleResult.exitCode !== 0 && failFast) aborted = true;
3909
- return stopped || childStopped ? { ...singleResult, output: stopMessage, error: stopMessage, exitCode: 1, interrupted: false, timedOut: false, stopped: true, skipped: false } : timedOut ? { ...singleResult, output: timeoutMessage ?? "Subagent timed out.", error: timeoutMessage ?? "Subagent timed out.", exitCode: 1, interrupted: false, timedOut: true, skipped: false } : { ...singleResult, skipped: false };
4148
+ appendJsonl(eventsPath, JSON.stringify({
4149
+ type: stopped || childStopped ? "subagent.step.stopped" : timedOut ? "subagent.step.failed" : childInterrupted ? "subagent.step.paused" : singleResult.exitCode === 0 ? "subagent.step.completed" : "subagent.step.failed",
4150
+ ts: taskEndTime, runId: id, stepIndex: fi, agent: task.agent,
4151
+ exitCode: stopped || childStopped ? 1 : timedOut ? 1 : childInterrupted ? 0 : singleResult.exitCode, durationMs: taskEndTime - taskStartTime,
4152
+ }));
4153
+ if (stopped || childStopped) appendTerminalChildStatusEvent(fi, taskEndTime);
4154
+ if (singleResult.exitCode !== 0 && failFast && !childStopped) aborted = true;
4155
+ return stopped || childStopped ? { ...singleResult, output: stopMessage, error: stopMessage, exitCode: 1, interrupted: false, timedOut: false, stopped: true, skipped: false } : timedOut ? { ...singleResult, output: singleResult.output || (timeoutMessage ?? "Subagent timed out."), error: singleResult.error ?? timeoutMessage ?? "Subagent timed out.", exitCode: 1, interrupted: false, timedOut: true, skipped: false } : { ...singleResult, skipped: false };
3910
4156
  }, globalSemaphore);
3911
4157
 
3912
4158
  flatIndex += dynamicSteps.length;
@@ -3938,6 +4184,7 @@ async function runSubagent(
3938
4184
  model: pr.model,
3939
4185
  attemptedModels: pr.attemptedModels,
3940
4186
  modelAttempts: pr.modelAttempts,
4187
+ contextOverflow: pr.contextOverflow,
3941
4188
  totalCost: pr.totalCost,
3942
4189
  artifactPaths: pr.artifactPaths,
3943
4190
  transcriptPath: pr.transcriptPath,
@@ -3945,6 +4192,7 @@ async function runSubagent(
3945
4192
  effects: pr.effects,
3946
4193
  execution: pr.execution,
3947
4194
  review: pr.review,
4195
+ timeoutRecovery: pr.timeoutRecovery,
3948
4196
  structuredOutput: pr.structuredOutput,
3949
4197
  structuredOutputPath: pr.structuredOutputPath,
3950
4198
  structuredOutputSchemaPath: pr.structuredOutputSchemaPath,
@@ -4157,6 +4405,7 @@ async function runSubagent(
4157
4405
  }
4158
4406
  if (timedOut) return timedOutStepResult(task.agent, task.context);
4159
4407
  if (stopped) return stoppedStepResult(task.agent, task.context);
4408
+ if (childStopRequests.has(fi)) return childStopResult(fi, task.agent, task.context);
4160
4409
  if (interrupted) return pausedStepResult(task.agent, task.context);
4161
4410
  if (aborted && failFast) {
4162
4411
  const skippedAt = Date.now();
@@ -4223,6 +4472,7 @@ async function runSubagent(
4223
4472
  registerTurnBudgetAbort: (abort) => registerStepTurnBudgetAbort(fi, abort),
4224
4473
  timeoutSignal: timeoutAbortController.signal,
4225
4474
  stopSignal: stopAbortController.signal,
4475
+ trackedMutationEvidenceForCompletionGuard: Boolean(worktreeSetup),
4226
4476
  timeoutMessage,
4227
4477
  stopMessage,
4228
4478
  turnBudget: config.turnBudget,
@@ -4232,7 +4482,8 @@ async function runSubagent(
4232
4482
  onWriterProcess,
4233
4483
  onExternalProcess: (process) => updateExternalProcess(fi, process),
4234
4484
  onExternalJob: (externalJob) => updateExternalJob(fi, externalJob),
4235
- skipAcceptance: () => timedOut || stopped,
4485
+ skipAcceptance: () => timedOut || stopped || childStopRequests.has(fi),
4486
+ orcaProgressTab,
4236
4487
  }), config.deadlineAt);
4237
4488
  if (task.sessionFile) {
4238
4489
  latestSessionFile = task.sessionFile;
@@ -4263,6 +4514,7 @@ async function runSubagent(
4263
4514
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "thinking", resolveEffectiveThinking(singleResult.model, requiredStatusStep(statusPayload, fi).thinking));
4264
4515
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "attemptedModels", singleResult.attemptedModels);
4265
4516
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "modelAttempts", singleResult.modelAttempts);
4517
+ setOptionalProperty(requiredStatusStep(statusPayload, fi), "contextOverflow", singleResult.contextOverflow);
4266
4518
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "totalCost", singleResult.totalCost);
4267
4519
  if (singleResult.totalCost) {
4268
4520
  pendingParallelUsageCost = {
@@ -4285,6 +4537,7 @@ async function runSubagent(
4285
4537
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "structuredOutputPath", singleResult.structuredOutputPath);
4286
4538
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "structuredOutputSchemaPath", singleResult.structuredOutputSchemaPath);
4287
4539
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "acceptance", singleResult.acceptance);
4540
+ setOptionalProperty(requiredStatusStep(statusPayload, fi), "timeoutRecovery", singleResult.timeoutRecovery);
4288
4541
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "watchdog", singleResult.watchdog);
4289
4542
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "capabilityCeiling", singleResult.capabilityCeiling);
4290
4543
  setOptionalProperty(requiredStatusStep(statusPayload, fi), "capabilityAudit", singleResult.capabilityAudit);
@@ -4299,6 +4552,7 @@ async function runSubagent(
4299
4552
  ts: taskEndTime, runId: id, stepIndex: fi, agent: task.agent,
4300
4553
  exitCode: stopped || childStopped ? 1 : timedOut ? 1 : childInterrupted ? 0 : singleResult.exitCode, durationMs: taskDuration,
4301
4554
  }));
4555
+ if (stopped || childStopped) appendTerminalChildStatusEvent(fi, taskEndTime);
4302
4556
  if (singleResult.completionGuardTriggered) {
4303
4557
  const event = buildControlEvent(omitUndefinedProperties({
4304
4558
  from: requiredStatusStep(statusPayload, fi).activityState,
@@ -4313,8 +4567,8 @@ async function runSubagent(
4313
4567
  appendControlEvent(event);
4314
4568
  }
4315
4569
 
4316
- if (singleResult.exitCode !== 0 && failFast) aborted = true;
4317
- return stopped || childStopped ? { ...singleResult, output: stopMessage, error: stopMessage, exitCode: 1, interrupted: false, timedOut: false, stopped: true, skipped: false } : timedOut ? { ...singleResult, output: timeoutMessage ?? "Subagent timed out.", error: timeoutMessage ?? "Subagent timed out.", exitCode: 1, interrupted: false, timedOut: true, skipped: false } : { ...singleResult, skipped: false };
4570
+ if (singleResult.exitCode !== 0 && failFast && !childStopped) aborted = true;
4571
+ return stopped || childStopped ? { ...singleResult, output: stopMessage, error: stopMessage, exitCode: 1, interrupted: false, timedOut: false, stopped: true, skipped: false } : timedOut ? { ...singleResult, output: singleResult.output || (timeoutMessage ?? "Subagent timed out."), error: singleResult.error ?? timeoutMessage ?? "Subagent timed out.", exitCode: 1, interrupted: false, timedOut: true, skipped: false } : { ...singleResult, skipped: false };
4318
4572
  },
4319
4573
  globalSemaphore,
4320
4574
  );
@@ -4366,14 +4620,16 @@ async function runSubagent(
4366
4620
  model: pr.model,
4367
4621
  attemptedModels: pr.attemptedModels,
4368
4622
  modelAttempts: pr.modelAttempts,
4623
+ contextOverflow: pr.contextOverflow,
4369
4624
  totalCost: pr.totalCost,
4370
4625
  artifactPaths: pr.artifactPaths,
4371
4626
  transcriptPath: pr.transcriptPath,
4372
4627
  transcriptError: pr.transcriptError,
4373
- effects: pr.effects,
4374
- execution: pr.execution,
4375
- review: pr.review,
4376
- structuredOutput: pr.structuredOutput,
4628
+ effects: pr.effects,
4629
+ execution: pr.execution,
4630
+ review: pr.review,
4631
+ timeoutRecovery: pr.timeoutRecovery,
4632
+ structuredOutput: pr.structuredOutput,
4377
4633
  structuredOutputPath: pr.structuredOutputPath,
4378
4634
  structuredOutputSchemaPath: pr.structuredOutputSchemaPath,
4379
4635
  acceptance: pr.acceptance,
@@ -4469,6 +4725,26 @@ async function runSubagent(
4469
4725
  }
4470
4726
  } else {
4471
4727
  const seqStep = step as SubagentStep;
4728
+ if (timedOut) {
4729
+ results.push(timedOutStepResult(seqStep.agent, seqStep.context));
4730
+ flatIndex++;
4731
+ continue;
4732
+ }
4733
+ if (stopped) {
4734
+ results.push(stoppedStepResult(seqStep.agent, seqStep.context));
4735
+ flatIndex++;
4736
+ continue;
4737
+ }
4738
+ if (childStopRequests.has(flatIndex)) {
4739
+ results.push(childStopResult(flatIndex, seqStep.agent, seqStep.context));
4740
+ flatIndex++;
4741
+ continue;
4742
+ }
4743
+ if (interrupted) {
4744
+ results.push(pausedStepResult(seqStep.agent, seqStep.context));
4745
+ flatIndex++;
4746
+ continue;
4747
+ }
4472
4748
  let singleWorktreeSetup: WorktreeSetup | undefined;
4473
4749
  if (seqStep.worktree) {
4474
4750
  try {
@@ -4553,7 +4829,8 @@ async function runSubagent(
4553
4829
  onWriterProcess,
4554
4830
  onExternalProcess: (process) => updateExternalProcess(flatIndex, process),
4555
4831
  onExternalJob: (externalJob) => updateExternalJob(flatIndex, externalJob),
4556
- skipAcceptance: () => timedOut || stopped,
4832
+ skipAcceptance: () => timedOut || stopped || childStopRequests.has(flatIndex),
4833
+ orcaProgressTab,
4557
4834
  }), config.deadlineAt);
4558
4835
  } catch (error) {
4559
4836
  if (singleWorktreeSetup) cleanupWorktrees(singleWorktreeSetup);
@@ -4572,7 +4849,7 @@ async function runSubagent(
4572
4849
  launchContractDigest: singleResult.launchContractDigest,
4573
4850
  launchResolvedExtensions: singleResult.launchResolvedExtensions,
4574
4851
  runtimeAcknowledgedExtensions: singleResult.runtimeAcknowledgedExtensions,
4575
- output: stopped || childStopped ? stopMessage : timedOut ? (timeoutMessage ?? "Subagent timed out.") : singleResult.output,
4852
+ output: stopped || childStopped ? stopMessage : timedOut ? singleResult.output || (timeoutMessage ?? "Subagent timed out.") : singleResult.output,
4576
4853
  outputState: singleResult.outputState,
4577
4854
  error: stopped || childStopped ? stopMessage : timedOut ? (timeoutMessage ?? "Subagent timed out.") : singleResult.error,
4578
4855
  protocolError: singleResult.protocolError,
@@ -4583,6 +4860,7 @@ async function runSubagent(
4583
4860
  model: singleResult.model,
4584
4861
  attemptedModels: singleResult.attemptedModels,
4585
4862
  modelAttempts: singleResult.modelAttempts,
4863
+ contextOverflow: singleResult.contextOverflow,
4586
4864
  totalCost: singleResult.totalCost,
4587
4865
  artifactPaths: singleResult.artifactPaths,
4588
4866
  transcriptPath: singleResult.transcriptPath,
@@ -4590,6 +4868,7 @@ async function runSubagent(
4590
4868
  effects: singleResult.effects,
4591
4869
  execution: singleResult.execution,
4592
4870
  review: singleResult.review,
4871
+ timeoutRecovery: singleResult.timeoutRecovery,
4593
4872
  structuredOutput: singleResult.structuredOutput,
4594
4873
  structuredOutputPath: singleResult.structuredOutputPath,
4595
4874
  structuredOutputSchemaPath: singleResult.structuredOutputSchemaPath,
@@ -4661,6 +4940,7 @@ async function runSubagent(
4661
4940
  setOptionalProperty(requiredStatusStep(statusPayload, flatIndex), "thinking", resolveEffectiveThinking(singleResult.model, requiredStatusStep(statusPayload, flatIndex).thinking));
4662
4941
  setOptionalProperty(requiredStatusStep(statusPayload, flatIndex), "attemptedModels", singleResult.attemptedModels);
4663
4942
  setOptionalProperty(requiredStatusStep(statusPayload, flatIndex), "modelAttempts", singleResult.modelAttempts);
4943
+ setOptionalProperty(requiredStatusStep(statusPayload, flatIndex), "contextOverflow", singleResult.contextOverflow);
4664
4944
  setOptionalProperty(requiredStatusStep(statusPayload, flatIndex), "totalCost", singleResult.totalCost);
4665
4945
  setOptionalProperty(requiredStatusStep(statusPayload, flatIndex), "error", stopped || childStopped ? stopMessage : timedOut ? (timeoutMessage ?? "Subagent timed out.") : singleResult.error);
4666
4946
  setOptionalProperty(requiredStatusStep(statusPayload, flatIndex), "transcriptPath", singleResult.transcriptPath ?? requiredStatusStep(statusPayload, flatIndex).transcriptPath);
@@ -4675,6 +4955,7 @@ async function runSubagent(
4675
4955
  setOptionalProperty(requiredStatusStep(statusPayload, flatIndex), "structuredOutputPath", singleResult.structuredOutputPath);
4676
4956
  setOptionalProperty(requiredStatusStep(statusPayload, flatIndex), "structuredOutputSchemaPath", singleResult.structuredOutputSchemaPath);
4677
4957
  setOptionalProperty(requiredStatusStep(statusPayload, flatIndex), "acceptance", singleResult.acceptance);
4958
+ setOptionalProperty(requiredStatusStep(statusPayload, flatIndex), "timeoutRecovery", singleResult.timeoutRecovery);
4678
4959
  setOptionalProperty(requiredStatusStep(statusPayload, flatIndex), "watchdog", singleResult.watchdog);
4679
4960
  setOptionalProperty(requiredStatusStep(statusPayload, flatIndex), "capabilityCeiling", singleResult.capabilityCeiling);
4680
4961
  setOptionalProperty(requiredStatusStep(statusPayload, flatIndex), "capabilityAudit", singleResult.capabilityAudit);
@@ -4698,6 +4979,7 @@ async function runSubagent(
4698
4979
  durationMs: stepEndTime - stepStartTime,
4699
4980
  tokens: stepTokens,
4700
4981
  }));
4982
+ if (stopped || childStopped) appendTerminalChildStatusEvent(flatIndex, stepEndTime);
4701
4983
  if (singleWorktreeSetup && !singleResult.detached) {
4702
4984
  const diffs = diffWorktrees(singleWorktreeSetup, [seqStep.agent], path.join(asyncDir, "worktree-diffs", `step-${stepIndex}`));
4703
4985
  const diffSummary = formatWorktreeDiffSummary(diffs);
@@ -4935,6 +5217,7 @@ async function runSubagent(
4935
5217
  model: r.model,
4936
5218
  attemptedModels: r.attemptedModels,
4937
5219
  modelAttempts: r.modelAttempts,
5220
+ contextOverflow: r.contextOverflow,
4938
5221
  totalCost: r.totalCost,
4939
5222
  artifactPaths: r.artifactPaths,
4940
5223
  outputSaveError: r.outputSaveError,
@@ -4957,6 +5240,7 @@ async function runSubagent(
4957
5240
  structuredOutputSchemaPath: r.structuredOutputSchemaPath,
4958
5241
  acceptance: r.acceptance,
4959
5242
  watchdog: r.watchdog,
5243
+ timeoutRecovery: r.timeoutRecovery,
4960
5244
  capabilityCeiling: r.capabilityCeiling,
4961
5245
  capabilityAudit: r.capabilityAudit,
4962
5246
  })),
@@ -4999,6 +5283,7 @@ async function runSubagent(
4999
5283
  statusPayload.lastUpdate = Date.now();
5000
5284
  }
5001
5285
  writeStatusPayload();
5286
+ orcaProgressTab?.finish(statusPayload.state === "complete" ? "completed" : statusPayload.state === "stopped" ? "stopped" : "failed", effectiveSessionFile);
5002
5287
  appendJsonl(
5003
5288
  eventsPath,
5004
5289
  JSON.stringify({