agentxchain 2.125.0 → 2.126.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentxchain",
-  "version": "2.125.0",
+  "version": "2.126.0",
   "description": "CLI for AgentXchain — governed multi-agent software delivery",
   "type": "module",
   "bin": {

package/src/commands/run.js

@@ -300,7 +300,7 @@ export async function executeGovernedRun(context, opts = {}) {
 
       // ── Route to adapter ──────────────────────────────────────────────
       const adapterOpts = {
-        signal: controller.signal,
+        signal: combineAbortSignals(controller.signal, ctx.dispatchAbortSignal),
         onStatus: (msg) => log(chalk.dim(`  ${msg}`)),
         verifyManifest: true,
         turnId: turn.turn_id,
@@ -557,3 +557,28 @@ function printManualQaFallback(log = console.log) {
   log(chalk.dim('  - Then recover the retained QA turn with: agentxchain step --resume'));
   log(chalk.dim('  - Guide: https://agentxchain.dev/docs/getting-started'));
 }
+
+function combineAbortSignals(primarySignal, secondarySignal) {
+  if (!secondarySignal) {
+    return primarySignal;
+  }
+  if (!primarySignal) {
+    return secondarySignal;
+  }
+  if (typeof AbortSignal.any === 'function') {
+    return AbortSignal.any([primarySignal, secondarySignal]);
+  }
+
+  const combined = new AbortController();
+  const forward = (signal) => {
+    if (!signal) return;
+    if (signal.aborted) {
+      combined.abort(signal.reason);
+      return;
+    }
+    signal.addEventListener('abort', () => combined.abort(signal.reason), { once: true });
+  };
+  forward(primarySignal);
+  forward(secondarySignal);
+  return combined.signal;
+}

package/src/commands/status.js

@@ -13,7 +13,7 @@ import { getContinuityStatus } from '../lib/continuity-status.js';
 import { getConnectorHealth } from '../lib/connector-health.js';
 import { readRepoDecisions, summarizeRepoDecisions } from '../lib/repo-decisions.js';
 import { deriveWorkflowKitArtifacts } from '../lib/workflow-kit-artifacts.js';
-import { evaluateTimeouts } from '../lib/timeout-evaluator.js';
+import { evaluateTimeouts, computeTimeoutBudget } from '../lib/timeout-evaluator.js';
 import { evaluateApprovalSlaReminders } from '../lib/notification-runner.js';
 import { summarizeRunProvenance } from '../lib/run-provenance.js';
 import { readRecentRunEventSummary } from '../lib/recent-event-summary.js';
@@ -283,7 +283,19 @@ function renderGovernedStatus(context, opts) {
           elapsedTag = m > 0 ? ` — ${m}m ${s % 60}s` : ` — ${s}s`;
         }
       }
-      console.log(`    ${marker} ${turn.turn_id} — ${chalk.bold(turn.assigned_role)} (${statusLabel}) [attempt ${turn.attempt}]${elapsedTag}`);
+      let budgetTag = '';
+      if (config.timeouts?.per_turn_minutes && turn.started_at) {
+        const tb = computeTimeoutBudget({ config, state, turn, now: new Date() });
+        const tBudget = tb.find((b) => b.scope === 'turn');
+        if (tBudget) {
+          if (tBudget.exceeded) {
+            budgetTag = ` ${chalk.red('[TIMEOUT]')}`;
+          } else {
+            budgetTag = ` ${chalk.dim(`[${tBudget.remaining_minutes}m left]`)}`;
+          }
+        }
+      }
+      console.log(`    ${marker} ${turn.turn_id} — ${chalk.bold(turn.assigned_role)} (${statusLabel}) [attempt ${turn.attempt}]${elapsedTag}${budgetTag}`);
       if (turn.status === 'conflicted' && turn.conflict_state) {
         const cs = turn.conflict_state;
         const files = cs.conflict_error?.conflicting_files || [];
@@ -314,6 +326,21 @@ function renderGovernedStatus(context, opts) {
         console.log(`  ${chalk.dim('Elapsed:')}  ${elapsed}`);
       }
     }
+    // Turn-level timeout budget inline with turn info
+    if (config.timeouts?.per_turn_minutes && singleActiveTurn.started_at) {
+      const turnBudgets = computeTimeoutBudget({ config, state, turn: singleActiveTurn, now: new Date() });
+      const turnBudget = turnBudgets.find((b) => b.scope === 'turn');
+      if (turnBudget) {
+        if (turnBudget.exceeded) {
+          console.log(`  ${chalk.dim('Budget:')}   ${chalk.red(`EXCEEDED — was ${turnBudget.limit_minutes}m, over by ${turnBudget.elapsed_minutes - turnBudget.limit_minutes}m`)}`);
+        } else {
+          const remMins = Math.floor(turnBudget.remaining_seconds / 60);
+          const remSecs = turnBudget.remaining_seconds % 60;
+          const remLabel = remMins > 0 ? `${remMins}m ${remSecs}s` : `${remSecs}s`;
+          console.log(`  ${chalk.dim('Budget:')}   ${chalk.green(`${remLabel} remaining`)} of ${turnBudget.limit_minutes}m (deadline ${new Date(turnBudget.deadline_iso).toLocaleTimeString()})`);
+        }
+      }
+    }
     if (singleActiveTurn.status === 'conflicted' && singleActiveTurn.conflict_state) {
       const cs = singleActiveTurn.conflict_state;
       const files = cs.conflict_error?.conflicting_files || [];
@@ -474,19 +501,22 @@ function renderGovernedStatus(context, opts) {
   renderWorkflowKitArtifactsSection(workflowKitArtifacts);
 
   if (config.timeouts && (state?.status === 'active' || approvalPending)) {
+    const nowDate = new Date();
     const activeTurn = state?.status === 'active' ? getActiveTurn(state) : null;
     const turnResult = activeTurn ? { role: activeTurn.assigned_role } : undefined;
-    const timeoutEval = evaluateTimeouts({ config, state, turn: activeTurn, turnResult, now: new Date().toISOString() });
+    const timeoutEval = evaluateTimeouts({ config, state, turn: activeTurn, turnResult, now: nowDate.toISOString() });
     const allItems = [...timeoutEval.exceeded, ...timeoutEval.warnings];
-    if (allItems.length > 0 || approvalPending) {
+    // Compute full budget for phase/run scopes (turn budget is shown inline with turn info above)
+    const budgets = computeTimeoutBudget({ config, state, turn: activeTurn, now: nowDate })
+      .filter((b) => b.scope !== 'turn'); // turn budget already shown inline
+
+    if (allItems.length > 0 || budgets.length > 0 || approvalPending) {
       console.log('');
       console.log(`  ${chalk.dim('Timeouts:')}`);
       if (approvalPending) {
         console.log(`    ${chalk.yellow('◷')} approval wait does not mutate timeout state; phase/run clocks keep ticking until the next accepted turn`);
       }
-      if (approvalPending && allItems.length === 0) {
-        console.log(`    ${chalk.dim('No current phase/run timeout pressure.')}`);
-      }
+      // Show exceeded/warned items
       for (const item of allItems) {
         const isExceeded = timeoutEval.exceeded.includes(item);
         const elapsed = item.elapsed_minutes != null ? `${item.elapsed_minutes}m` : '?';
@@ -495,6 +525,17 @@ function renderGovernedStatus(context, opts) {
         const label = isExceeded ? chalk.red(`EXCEEDED ${item.scope}`) : chalk.yellow(`${item.scope}`);
         console.log(`    ${icon} ${label}: ${elapsed}/${limit} (action: ${item.action || 'n/a'})`);
       }
+      // Show remaining budget for non-exceeded phase/run scopes
+      const exceededScopes = new Set(allItems.map((i) => `${i.scope}:${i.phase || ''}`));
+      for (const b of budgets) {
+        const key = `${b.scope}:${b.phase || ''}`;
+        if (exceededScopes.has(key)) continue; // already shown as exceeded above
+        const scopeLabel = b.scope === 'phase' ? `phase (${b.phase})` : b.scope;
+        console.log(`    ${chalk.green('✓')} ${scopeLabel}: ${b.elapsed_minutes}m/${b.limit_minutes}m — ${chalk.green(`${b.remaining_minutes}m remaining`)}`);
+      }
+      if (approvalPending && allItems.length === 0 && budgets.length === 0) {
+        console.log(`    ${chalk.dim('No current phase/run timeout pressure.')}`);
+      }
     }
   }
 

package/src/commands/turn.js

@@ -3,6 +3,7 @@ import { join } from 'path';
 import chalk from 'chalk';
 import { loadProjectContext, loadProjectState } from '../lib/config.js';
 import { getActiveTurnCount, getActiveTurns } from '../lib/governed-state.js';
+import { computeTimeoutBudget } from '../lib/timeout-evaluator.js';
 import {
   getDispatchAssignmentPath,
   getDispatchContextPath,
@@ -54,11 +55,11 @@ export function turnShowCommand(turnId, opts) {
   }
 
   if (opts.json) {
-    console.log(JSON.stringify(buildTurnPayload(selectedTurnId, turn, state, artifacts, assignment), null, 2));
+    console.log(JSON.stringify(buildTurnPayload(selectedTurnId, turn, state, artifacts, assignment, context.config), null, 2));
     return;
   }
 
-  printTurnSummary(selectedTurnId, turn, state, artifacts, assignment);
+  printTurnSummary(selectedTurnId, turn, state, artifacts, assignment, context.config);
 }
 
 function requireGovernedContext() {
@@ -118,9 +119,9 @@ function buildArtifactIndex(root, turnId) {
   );
 }
 
-function buildTurnPayload(turnId, turn, state, artifacts, assignment) {
+function buildTurnPayload(turnId, turn, state, artifacts, assignment, config) {
   const elapsedMs = getElapsedMs(turn.started_at);
-  return {
+  const payload = {
     turn_id: turnId,
     run_id: state.run_id || assignment?.run_id || null,
     phase: state.phase || assignment?.phase || null,
@@ -140,9 +141,17 @@ function buildTurnPayload(turnId, turn, state, artifacts, assignment) {
       }]),
     ),
   };
+  // Add timeout budget if configured
+  if (config?.timeouts) {
+    const budgets = computeTimeoutBudget({ config, state, turn, now: new Date() });
+    if (budgets.length > 0) {
+      payload.timeout_budget = budgets;
+    }
+  }
+  return payload;
 }
 
-function printTurnSummary(turnId, turn, state, artifacts, assignment) {
+function printTurnSummary(turnId, turn, state, artifacts, assignment, config) {
   const elapsedMs = getElapsedMs(turn.started_at);
   console.log('');
   console.log(chalk.bold(`  Turn: ${chalk.cyan(turnId)}`));
@@ -159,6 +168,21 @@ function printTurnSummary(turnId, turn, state, artifacts, assignment) {
   if (elapsedMs != null) {
     console.log(`  ${chalk.dim('Elapsed:')}  ${formatElapsed(elapsedMs)}`);
   }
+  // Timeout budget per scope
+  if (config?.timeouts) {
+    const budgets = computeTimeoutBudget({ config, state, turn, now: new Date() });
+    for (const b of budgets) {
+      const scopeLabel = b.scope === 'phase' ? `phase (${b.phase})` : b.scope;
+      if (b.exceeded) {
+        console.log(`  ${chalk.dim('Timeout:')}  ${chalk.red(`${scopeLabel} EXCEEDED`)} — was ${b.limit_minutes}m, over by ${b.elapsed_minutes - b.limit_minutes}m`);
+      } else {
+        const remMins = Math.floor(b.remaining_seconds / 60);
+        const remSecs = b.remaining_seconds % 60;
+        const remLabel = remMins > 0 ? `${remMins}m ${remSecs}s` : `${remSecs}s`;
+        console.log(`  ${chalk.dim('Timeout:')}  ${scopeLabel} — ${chalk.green(`${remLabel} remaining`)} of ${b.limit_minutes}m`);
+      }
+    }
+  }
   console.log(`  ${chalk.dim('Dispatch:')} ${getDispatchTurnDir(turnId)}`);
   if (assignment?.staging_result_path) {
     console.log(`  ${chalk.dim('Staging:')}  ${assignment.staging_result_path}`);

package/src/lib/dashboard/timeout-status.js

@@ -9,7 +9,7 @@
 
 import { join } from 'path';
 import { loadProjectContext, loadProjectState } from '../config.js';
-import { evaluateTimeouts } from '../timeout-evaluator.js';
+import { evaluateTimeouts, computeTimeoutBudget } from '../timeout-evaluator.js';
 import { readJsonlFile } from './state-reader.js';
 
 /**
@@ -209,7 +209,15 @@ export function readTimeoutStatus(workspacePath) {
   const configSummary = buildTimeoutConfigSummary(timeouts, config.routing);
 
   // Live timeout evaluation — only meaningful when the run is active
-  const live = evaluateDashboardTimeoutPressure(config, state, new Date());
+  const nowDate = new Date();
+  const live = evaluateDashboardTimeoutPressure(config, state, nowDate);
+
+  // Compute remaining budget for all configured scopes
+  const activeTurnsList = getActiveTurns(state);
+  const primaryTurn = activeTurnsList.length === 1 ? activeTurnsList[0] : null;
+  const budget = (state?.status === 'active' || Boolean(state?.pending_phase_transition || state?.pending_run_completion))
+    ? computeTimeoutBudget({ config, state, turn: primaryTurn, now: nowDate })
+    : [];
 
   // Persisted timeout events from the decision ledger
   const ledger = readJsonlFile(agentxchainDir, 'decision-ledger.jsonl');
@@ -223,6 +231,7 @@ export function readTimeoutStatus(workspacePath) {
         configured: true,
         config: configSummary,
         live,
+        budget,
         live_context: buildLiveContext(state),
         events,
       },

package/src/lib/run-loop.js

@@ -12,7 +12,7 @@
  *   - Never calls process dot exit
  *   - No stdout/stderr
  *   - No adapter dispatch (caller provides dispatch callback)
- *   - Imports only from runner-interface.js
+ *   - Governed lifecycle operations import through runner-interface.js
  */
 
 import {
@@ -21,6 +21,7 @@ import {
   assignTurn,
   acceptTurn,
   rejectTurn,
+  markRunBlocked,
   writeDispatchBundle,
   getTurnStagingResultPath,
   approvePhaseGate,
@@ -33,10 +34,11 @@ import {
 } from './runner-interface.js';
 
 import { runAdmissionControl } from './admission-control.js';
-import { mkdirSync, writeFileSync } from 'fs';
+import { appendFileSync, mkdirSync, writeFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { evaluateApprovalSlaReminders } from './notification-runner.js';
 import { readPreemptionMarker } from './intake.js';
+import { buildTimeoutBlockedReason, evaluateTimeouts } from './timeout-evaluator.js';
 
 const DEFAULT_MAX_TURNS = 50;
 
@@ -214,6 +216,7 @@ async function executeSequentialTurn(root, config, state, callbacks, emit, error
 async function executeParallelTurns(root, config, state, maxConcurrent, callbacks, emit, errors) {
   const history = [];
   let acceptedCount = 0;
+  const timedOutDispatches = [];
 
   // ── Collect active turns that need dispatch (retries) ────────────────
   const activeTurns = getActiveTurns(state);
@@ -332,7 +335,7 @@ async function executeParallelTurns(root, config, state, maxConcurrent, callback
   const dispatchResults = await Promise.allSettled(
     contexts.map(async (ctx) => {
       try {
-        return { ctx, result: await callbacks.dispatch(ctx) };
+        return { ctx, result: await dispatchWithTimeout(ctx, config, callbacks.dispatch) };
       } catch (err) {
         return { ctx, result: { accept: false, reason: `dispatch threw: ${err.message}` } };
       }
@@ -350,6 +353,11 @@ async function executeParallelTurns(root, config, state, maxConcurrent, callback
     const { turn } = ctx;
     const roleId = turn.assigned_role;
 
+    if (dispatchResult?.timed_out === true) {
+      timedOutDispatches.push({ ctx, dispatchResult });
+      continue;
+    }
+
     if (dispatchResult.accept) {
       const absStaging = join(root, ctx.stagingPath);
       mkdirSync(dirname(absStaging), { recursive: true });
@@ -405,6 +413,13 @@ async function executeParallelTurns(root, config, state, maxConcurrent, callback
     }
   }
 
+  if (timedOutDispatches.length > 0) {
+    const timedOut = timedOutDispatches[0];
+    const blocked = persistDispatchTimeout(root, config, timedOut.ctx.turn, timedOut.dispatchResult.timeout_result, errors);
+    emit({ type: 'blocked', state: blocked.state, reason: 'timeout:turn' });
+    return { terminal: true, ok: false, stop_reason: 'blocked', history, acceptedCount };
+  }
+
   // ── Stall detection: if no turns were accepted and no new roles were ──
   // ── assignable, terminate to avoid infinite re-dispatch loops. ────────
   if (acceptedCount === 0 && history.length > 0) {
@@ -445,12 +460,18 @@ async function dispatchAndProcess(root, config, turn, assignState, callbacks, em
 
   let dispatchResult;
   try {
-    dispatchResult = await callbacks.dispatch(context);
+    dispatchResult = await dispatchWithTimeout(context, config, callbacks.dispatch);
   } catch (err) {
     errors.push(`dispatch threw for ${roleId}: ${err.message}`);
     return { terminal: true, ok: false, stop_reason: 'dispatch_error', history };
   }
 
+  if (dispatchResult?.timed_out === true) {
+    const blocked = persistDispatchTimeout(root, config, turn, dispatchResult.timeout_result, errors);
+    emit({ type: 'blocked', state: blocked.state, reason: 'timeout:turn' });
+    return { terminal: true, ok: false, stop_reason: 'blocked', history };
+  }
+
   if (dispatchResult.accept) {
     const absStaging = join(root, stagingPath);
     mkdirSync(dirname(absStaging), { recursive: true });
@@ -574,3 +595,107 @@ function makeResult(ok, stop_reason, state, turns_executed, turn_history, gates_
 function noop() {}
 
 export { DEFAULT_MAX_TURNS };
+
+function buildTimeoutLedgerEntry(timeoutResult, timestamp, turnId, phase) {
+  return {
+    type: 'timeout',
+    scope: timeoutResult.scope,
+    phase: timeoutResult.phase || phase || null,
+    turn_id: turnId || null,
+    limit_minutes: timeoutResult.limit_minutes,
+    elapsed_minutes: timeoutResult.elapsed_minutes,
+    exceeded_by_minutes: timeoutResult.exceeded_by_minutes,
+    action: timeoutResult.action,
+    timestamp,
+  };
+}
+
+function appendJsonl(root, relPath, value) {
+  appendFileSync(join(root, relPath), `${JSON.stringify(value)}\n`);
+}
+
+function getDispatchTimeoutResult(config, state, turn, now = new Date()) {
+  const evaluation = evaluateTimeouts({ config, state, turn, now });
+  return evaluation.exceeded.find((entry) => entry.scope === 'turn' && entry.action === 'escalate') || null;
+}
+
+async function dispatchWithTimeout(context, config, dispatchFn) {
+  const timeoutResult = getDispatchTimeoutResult(config, context.state, context.turn);
+  if (!timeoutResult) {
+    return await dispatchFn(context);
+  }
+
+  const remainingMs = Math.max(
+    0,
+    timeoutResult.limit_minutes * 60 * 1000
+      - Math.max(0, new Date() - new Date(context.turn.started_at || context.turn.assigned_at || new Date())),
+  );
+  const abortController = new AbortController();
+  if (remainingMs === 0) {
+    abortController.abort(new Error(`Turn timeout exceeded after ${timeoutResult.limit_minutes}m`));
+    return {
+      timed_out: true,
+      timeout_result: timeoutResult,
+    };
+  }
+  const enrichedContext = {
+    ...context,
+    dispatchTimeoutMs: remainingMs,
+    dispatchDeadlineAt: new Date(Date.now() + remainingMs).toISOString(),
+    dispatchAbortSignal: abortController.signal,
+  };
+
+  let timer = null;
+  const dispatchPromise = Promise.resolve(dispatchFn(enrichedContext))
+    .then((result) => ({ kind: 'result', result }))
+    .catch((error) => ({ kind: 'error', error }));
+  const timeoutPromise = new Promise((resolve) => {
+    timer = setTimeout(() => {
+      abortController.abort(new Error(`Turn timeout exceeded after ${timeoutResult.limit_minutes}m`));
+      resolve({ kind: 'timeout', timeoutResult });
+    }, remainingMs);
+  });
+
+  const winner = await Promise.race([dispatchPromise, timeoutPromise]);
+  clearTimeout(timer);
+
+  if (winner.kind === 'timeout') {
+    return {
+      timed_out: true,
+      timeout_result: winner.timeoutResult,
+    };
+  }
+
+  if (winner.kind === 'error') {
+    throw winner.error;
+  }
+
+  return winner.result;
+}
+
+function persistDispatchTimeout(root, config, turn, timeoutResult, errors) {
+  const blockedAt = new Date().toISOString();
+  const blockedReason = buildTimeoutBlockedReason(timeoutResult, { turnRetained: true });
+  const blocked = markRunBlocked(root, {
+    blockedOn: `timeout:${timeoutResult.scope}`,
+    category: blockedReason.category,
+    recovery: blockedReason.recovery,
+    turnId: turn.turn_id,
+    blockedAt,
+    notificationConfig: config,
+  });
+
+  if (!blocked.ok) {
+    errors.push(`markRunBlocked(timeout): ${blocked.error}`);
+    return { state: loadState(root, config) };
+  }
+
+  try {
+    appendJsonl(root, '.agentxchain/decision-ledger.jsonl', buildTimeoutLedgerEntry(timeoutResult, blockedAt, turn.turn_id, blocked.state?.phase));
+  } catch (err) {
+    errors.push(`timeout ledger append failed: ${err.message}`);
+  }
+
+  errors.push(`dispatch timed out for ${turn.assigned_role} after ${timeoutResult.limit_minutes}m`);
+  return blocked;
+}

package/src/lib/timeout-evaluator.js

@@ -210,6 +210,93 @@ export function validateTimeoutsConfig(timeouts, routing) {
   return { ok: errors.length === 0, errors };
 }
 
+/**
+ * Compute remaining timeout budget for an active turn/phase/run.
+ *
+ * Unlike evaluateTimeouts() which only returns items when exceeded,
+ * this returns budget info for ALL configured timeout scopes regardless
+ * of whether the deadline has passed.
+ *
+ * @param {object} options
+ * @param {object} options.config - Normalized config with optional `timeouts` section
+ * @param {object} options.state - Current governed state
+ * @param {object} [options.turn] - Active turn metadata
+ * @param {Date|string} [options.now] - Override for current time (testing)
+ * @returns {Array<TimeoutBudget>} Array of { scope, limit_minutes, elapsed_minutes, remaining_minutes, deadline_iso, exceeded, action }
+ */
+export function computeTimeoutBudget({ config, state, turn = null, now = new Date() }) {
+  const timeouts = config?.timeouts;
+  if (!timeouts) return [];
+
+  const nowMs = typeof now === 'string' ? new Date(now).getTime() : now.getTime();
+  const budgets = [];
+
+  // Per-turn budget
+  if (timeouts.per_turn_minutes && turn) {
+    const startedAt = turn.started_at || turn.assigned_at;
+    if (startedAt) {
+      const dispatchMs = new Date(startedAt).getTime();
+      const limitMs = timeouts.per_turn_minutes * 60 * 1000;
+      const elapsedMs = nowMs - dispatchMs;
+      const remainingMs = limitMs - elapsedMs;
+      budgets.push({
+        scope: 'turn',
+        limit_minutes: timeouts.per_turn_minutes,
+        elapsed_minutes: Math.round(elapsedMs / 60000),
+        remaining_minutes: Math.max(0, Math.round(remainingMs / 60000)),
+        remaining_seconds: Math.max(0, Math.round(remainingMs / 1000)),
+        deadline_iso: new Date(dispatchMs + limitMs).toISOString(),
+        exceeded: elapsedMs > limitMs,
+        action: resolveAction(timeouts.action, 'turn'),
+      });
+    }
+  }
+
+  // Per-phase budget
+  const phaseLimit = resolvePhaseLimit(timeouts, config.routing, state.phase);
+  const phaseAction = resolvePhaseAction(timeouts, config.routing, state.phase);
+  if (phaseLimit) {
+    const phaseEnteredAt = findPhaseEntryTime(state);
+    if (phaseEnteredAt) {
+      const entryMs = new Date(phaseEnteredAt).getTime();
+      const limitMs = phaseLimit * 60 * 1000;
+      const elapsedMs = nowMs - entryMs;
+      const remainingMs = limitMs - elapsedMs;
+      budgets.push({
+        scope: 'phase',
+        phase: state.phase,
+        limit_minutes: phaseLimit,
+        elapsed_minutes: Math.round(elapsedMs / 60000),
+        remaining_minutes: Math.max(0, Math.round(remainingMs / 60000)),
+        remaining_seconds: Math.max(0, Math.round(remainingMs / 1000)),
+        deadline_iso: new Date(entryMs + limitMs).toISOString(),
+        exceeded: elapsedMs > limitMs,
+        action: phaseAction,
+      });
+    }
+  }
+
+  // Per-run budget
+  if (timeouts.per_run_minutes && state.created_at) {
+    const createMs = new Date(state.created_at).getTime();
+    const limitMs = timeouts.per_run_minutes * 60 * 1000;
+    const elapsedMs = nowMs - createMs;
+    const remainingMs = limitMs - elapsedMs;
+    budgets.push({
+      scope: 'run',
+      limit_minutes: timeouts.per_run_minutes,
+      elapsed_minutes: Math.round(elapsedMs / 60000),
+      remaining_minutes: Math.max(0, Math.round(remainingMs / 60000)),
+      remaining_seconds: Math.max(0, Math.round(remainingMs / 1000)),
+      deadline_iso: new Date(createMs + limitMs).toISOString(),
+      exceeded: elapsedMs > limitMs,
+      action: resolveAction(timeouts.action, 'run'),
+    });
+  }
+
+  return budgets;
+}
+
 /**
  * Build a blocked_reason descriptor for a timeout.
  */