agentxchain 2.109.0 → 2.110.0

package/dashboard/components/blocked.js

@@ -120,8 +120,10 @@ function renderGateActionFailure(gateActions, state) {
     html += `<div class="annotation-list">`;
     for (const action of actions) {
       const label = action.action_label || action.command || `action ${action.action_index || '?'}`;
-      const outcome = action.status === 'failed' ? '❌ failed' : '✅ succeeded';
-      const exitStr = action.exit_code != null ? ` (exit ${action.exit_code})` : '';
+      const outcome = action.status === 'failed'
+        ? (action.timed_out ? `⏱ timed out after ${action.timeout_ms}ms` : '❌ failed')
+        : '✅ succeeded';
+      const exitStr = action.timed_out ? '' : (action.exit_code != null ? ` (exit ${action.exit_code})` : '');
       html += `<div class="annotation-card">
         <span class="mono">${esc(String(action.action_index || '?'))}.</span>
         <span>${esc(label)}</span>

package/dashboard/components/gate.js

@@ -240,9 +240,12 @@ function renderGateActionsSection(gateActions) {
       html += `<ul>`;
       for (const a of attempt.actions) {
         const aLabel = a.action_label || a.command || `action ${a.action_index || '?'}`;
-        const outcome = a.status === 'failed' ? '❌' : '✅';
-        const exitStr = a.exit_code != null ? ` (exit ${a.exit_code})` : '';
-        html += `<li>${outcome} ${esc(aLabel)}${esc(exitStr)}</li>`;
+        const outcome = a.status === 'failed'
+          ? (a.timed_out ? '⏱' : '❌')
+          : '✅';
+        const timeoutStr = a.timed_out ? ` timed out after ${a.timeout_ms}ms` : '';
+        const exitStr = a.timed_out ? '' : (a.exit_code != null ? ` (exit ${a.exit_code})` : '');
+        html += `<li>${outcome} ${esc(aLabel)}${esc(exitStr)}${esc(timeoutStr)}</li>`;
       }
       html += `</ul>`;
     }

package/package.json

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

package/src/commands/approve-completion.js

@@ -44,7 +44,8 @@ export async function approveCompletionCommand(opts) {
     if (result.gate_actions?.length > 0) {
       console.log(`  ${chalk.dim('Gate actions:')} ${result.gate_actions.length}`);
       for (const action of result.gate_actions) {
-        console.log(`    ${action.index}. ${action.label || action.run}`);
+        const timeoutHint = action.timeout_ms && action.timeout_ms !== 900_000 ? chalk.dim(` [timeout: ${action.timeout_ms}ms]`) : '';
+        console.log(`    ${action.index}. ${action.label || action.run}${timeoutHint}`);
         if (action.label) {
           console.log(`       ${chalk.dim(action.run)}`);
         }
@@ -103,6 +104,10 @@ function printGateHookFailure(result, gateType, gateInfo) {
 
 function printGateActionFailure(result, gateInfo) {
   const failure = result.gateActionRun?.failed_action;
+  const exitLabel = failure?.timed_out
+    ? `timeout after ${failure.timeout_ms}ms`
+    : failure?.exit_code ?? failure?.signal ?? 'unknown';
+  const stderrOrError = failure?.stderr_tail || failure?.spawn_error || null;
 
   console.log('');
   console.log(chalk.yellow('  Run Completion Blocked By Gate Action'));
@@ -110,9 +115,9 @@ function printGateActionFailure(result, gateInfo) {
   console.log('');
   console.log(`  ${chalk.dim('Gate:')}     ${gateInfo.gate}`);
   console.log(`  ${chalk.dim('Action:')}   ${failure?.action_label || failure?.command || '(unknown)'}`);
-  console.log(`  ${chalk.dim('Exit:')}     ${failure?.exit_code ?? failure?.signal ?? 'unknown'}`);
-  if (failure?.stderr_tail) {
-    console.log(`  ${chalk.dim('stderr:')}   ${failure.stderr_tail}`);
+  console.log(`  ${chalk.dim('Exit:')}     ${exitLabel}`);
+  if (stderrOrError) {
+    console.log(`  ${chalk.dim('stderr:')}   ${stderrOrError}`);
   }
   console.log(`  ${chalk.dim('Retry:')}    agentxchain approve-completion`);
   console.log('');

package/src/commands/approve-transition.js

@@ -43,7 +43,8 @@ export async function approveTransitionCommand(opts) {
     if (result.gate_actions?.length > 0) {
       console.log(`  ${chalk.dim('Gate actions:')} ${result.gate_actions.length}`);
       for (const action of result.gate_actions) {
-        console.log(`    ${action.index}. ${action.label || action.run}`);
+        const timeoutHint = action.timeout_ms && action.timeout_ms !== 900_000 ? chalk.dim(` [timeout: ${action.timeout_ms}ms]`) : '';
+        console.log(`    ${action.index}. ${action.label || action.run}${timeoutHint}`);
         if (action.label) {
           console.log(`       ${chalk.dim(action.run)}`);
         }
@@ -108,6 +109,10 @@ function printGateHookFailure(result, gateType, gateInfo) {
 
 function printGateActionFailure(result, gateType, gateInfo) {
   const failure = result.gateActionRun?.failed_action;
+  const exitLabel = failure?.timed_out
+    ? `timeout after ${failure.timeout_ms}ms`
+    : failure?.exit_code ?? failure?.signal ?? 'unknown';
+  const stderrOrError = failure?.stderr_tail || failure?.spawn_error || null;
 
   console.log('');
   console.log(chalk.yellow(`  ${gateType === 'phase_transition' ? 'Phase Transition' : 'Run Completion'} Blocked By Gate Action`));
@@ -119,9 +124,9 @@ function printGateActionFailure(result, gateType, gateInfo) {
   }
   console.log(`  ${chalk.dim('Gate:')}     ${gateInfo.gate}`);
   console.log(`  ${chalk.dim('Action:')}   ${failure?.action_label || failure?.command || '(unknown)'}`);
-  console.log(`  ${chalk.dim('Exit:')}     ${failure?.exit_code ?? failure?.signal ?? 'unknown'}`);
-  if (failure?.stderr_tail) {
-    console.log(`  ${chalk.dim('stderr:')}   ${failure.stderr_tail}`);
+  console.log(`  ${chalk.dim('Exit:')}     ${exitLabel}`);
+  if (stderrOrError) {
+    console.log(`  ${chalk.dim('stderr:')}   ${stderrOrError}`);
   }
   console.log(`  ${chalk.dim('Retry:')}    ${gateType === 'phase_transition' ? 'agentxchain approve-transition' : 'agentxchain approve-completion'}`);
   console.log('');

package/src/commands/status.js

@@ -358,9 +358,9 @@ function renderGovernedStatus(context, opts) {
     for (const action of gateActionAttempt.actions) {
       const label = action.action_label || action.command || `action ${action.action_index || '?'}`;
       const outcome = action.status === 'failed'
-        ? chalk.red('failed')
+        ? (action.timed_out ? chalk.red(`timed out after ${action.timeout_ms}ms`) : chalk.red('failed'))
         : chalk.green('succeeded');
-      const exit = action.exit_code == null ? '' : ` (exit ${action.exit_code})`;
+      const exit = action.timed_out ? '' : (action.exit_code == null ? '' : ` (exit ${action.exit_code})`);
       console.log(`    ${action.action_index || '?'}. ${label} — ${outcome}${exit}`);
       if (action.status === 'failed' && action.stderr_tail) {
         console.log(`      ${chalk.dim(action.stderr_tail)}`);

package/src/lib/gate-actions.js

@@ -5,6 +5,16 @@ import { spawnSync } from 'child_process';
 
 const LEDGER_PATH = '.agentxchain/decision-ledger.jsonl';
 const MAX_OUTPUT_TAIL_CHARS = 1200;
+export const DEFAULT_GATE_ACTION_TIMEOUT_MS = 15 * 60 * 1000;
+const MIN_GATE_ACTION_TIMEOUT_MS = 1000;
+const MAX_GATE_ACTION_TIMEOUT_MS = 60 * 60 * 1000;
+
+function normalizeGateActionTimeoutMs(action) {
+  if (Number.isInteger(action?.timeout_ms)) {
+    return action.timeout_ms;
+  }
+  return DEFAULT_GATE_ACTION_TIMEOUT_MS;
+}
 
 export function validateGateActionsConfig(gates, errors) {
   if (!gates || typeof gates !== 'object' || Array.isArray(gates)) {
@@ -44,6 +54,15 @@ export function validateGateActionsConfig(gates, errors) {
       if ('label' in action && (typeof action.label !== 'string' || !action.label.trim())) {
         errors.push(`${prefix}.label must be a non-empty string when provided`);
       }
+      if ('timeout_ms' in action) {
+        if (!Number.isInteger(action.timeout_ms)
+          || action.timeout_ms < MIN_GATE_ACTION_TIMEOUT_MS
+          || action.timeout_ms > MAX_GATE_ACTION_TIMEOUT_MS) {
+          errors.push(
+            `${prefix}.timeout_ms must be an integer between ${MIN_GATE_ACTION_TIMEOUT_MS} and ${MAX_GATE_ACTION_TIMEOUT_MS} when provided`,
+          );
+        }
+      }
     }
   }
 }
@@ -60,6 +79,7 @@ export function getGateActions(config, gateId) {
       index: index + 1,
       label: typeof action.label === 'string' && action.label.trim() ? action.label.trim() : null,
       run: action.run.trim(),
+      timeout_ms: normalizeGateActionTimeoutMs(action),
     }));
 }
 
@@ -78,6 +98,11 @@ function trimOutputTail(value) {
 }
 
 function buildGateActionEntry(action, meta, runtimeResult, status) {
+  const timedOut = runtimeResult?.error?.code === 'ETIMEDOUT';
+  const stderrTail = trimOutputTail(runtimeResult?.stderr) || (timedOut ? `Timed out after ${action.timeout_ms}ms` : null);
+  const spawnError = timedOut
+    ? `Timed out after ${action.timeout_ms}ms`
+    : runtimeResult?.error?.message || null;
   return {
     type: 'gate_action',
     timestamp: new Date().toISOString(),
@@ -90,12 +115,14 @@ function buildGateActionEntry(action, meta, runtimeResult, status) {
     action_index: action.index,
     action_label: action.label,
     command: action.run,
+    timeout_ms: action.timeout_ms,
     status,
     exit_code: Number.isInteger(runtimeResult?.status) ? runtimeResult.status : null,
     signal: runtimeResult?.signal || null,
     stdout_tail: trimOutputTail(runtimeResult?.stdout),
-    stderr_tail: trimOutputTail(runtimeResult?.stderr),
-    spawn_error: runtimeResult?.error?.message || null,
+    stderr_tail: stderrTail,
+    spawn_error: spawnError,
+    timed_out: timedOut,
   };
 }
 
@@ -125,6 +152,8 @@ export function executeGateActions(root, config, meta, opts = {}) {
       },
       encoding: 'utf8',
       maxBuffer: 10 * 1024 * 1024,
+      timeout: action.timeout_ms,
+      killSignal: 'SIGTERM',
     });
 
     const status = runtimeResult.error || runtimeResult.status !== 0 ? 'failed' : 'succeeded';
@@ -170,6 +199,8 @@ export function normalizeGateActionEntry(entry) {
     stdout_tail: entry.stdout_tail || null,
     stderr_tail: entry.stderr_tail || null,
     spawn_error: entry.spawn_error || null,
+    timeout_ms: Number.isInteger(entry.timeout_ms) ? entry.timeout_ms : null,
+    timed_out: entry.timed_out === true,
     timestamp: entry.timestamp || null,
   };
 }

package/src/lib/governed-state.js

@@ -1281,6 +1281,8 @@ function blockRunForGateActionFailure(root, state, gateFailure, config) {
     : 'agentxchain approve-transition';
   const actionLabel = gateFailure.action_label || gateFailure.command || gateFailure.gate_id || 'gate action';
   const blockedAt = gateFailure.timestamp || new Date().toISOString();
+  const failureVerb = gateFailure.timed_out ? 'timed out' : 'failed';
+  const failureDetail = `Gate action ${failureVerb} for "${gateFailure.gate_id || 'unknown'}": ${actionLabel}`;
   const blockedState = {
     ...state,
     status: 'blocked',
@@ -1289,13 +1291,13 @@ function blockRunForGateActionFailure(root, state, gateFailure, config) {
       category: 'gate_action_failed',
       blocked_at: blockedAt,
       turn_id: gateFailure.requested_by_turn || null,
-      detail: `Gate action failed for "${gateFailure.gate_id || 'unknown'}": ${actionLabel}`,
+      detail: failureDetail,
       recovery: {
         typed_reason: 'gate_action_failed',
         owner: 'human',
         recovery_action: recoveryAction,
         turn_retained: false,
-        detail: `${gateFailure.gate_id || 'unknown'} action ${gateFailure.action_index || '?'} (${actionLabel})`,
+        detail: `${gateFailure.gate_id || 'unknown'} action ${gateFailure.action_index || '?'} (${actionLabel})${gateFailure.timed_out ? ` timed out after ${gateFailure.timeout_ms}ms` : ''}`,
       },
       gate_action: {
         attempt_id: gateFailure.attempt_id || null,
@@ -1306,6 +1308,8 @@ function blockRunForGateActionFailure(root, state, gateFailure, config) {
         command: gateFailure.command || null,
         exit_code: gateFailure.exit_code ?? null,
         stderr_tail: gateFailure.stderr_tail || null,
+        timeout_ms: gateFailure.timeout_ms ?? null,
+        timed_out: gateFailure.timed_out === true,
       },
     },
   };

package/src/lib/report.js

@@ -1444,7 +1444,8 @@ export function formatGovernanceReportText(report) {
       for (const action of run.gate_actions) {
         const label = action.action_label || action.command || `action ${action.action_index || '?'}`;
         const exit = action.exit_code == null ? 'n/a' : String(action.exit_code);
-        lines.push(`  - ${action.gate_id || 'unknown'} | ${action.gate_type || 'unknown'} | action ${action.action_index || '?'} | ${action.status} | ${label} | exit: ${exit} | at: ${action.timestamp || 'n/a'}`);
+        const timeoutTag = action.timed_out ? ` | timed_out after ${action.timeout_ms}ms` : '';
+        lines.push(`  - ${action.gate_id || 'unknown'} | ${action.gate_type || 'unknown'} | action ${action.action_index || '?'} | ${action.status} | ${label} | exit: ${exit}${timeoutTag} | at: ${action.timestamp || 'n/a'}`);
         if (action.stderr_tail) {
           lines.push(`      stderr: ${action.stderr_tail}`);
         }
@@ -2014,7 +2015,8 @@ export function formatGovernanceReportMarkdown(report) {
       for (const action of run.gate_actions) {
         const label = action.action_label || action.command || `action ${action.action_index || '?'}`;
         const exit = action.exit_code == null ? 'n/a' : String(action.exit_code);
-        lines.push(`- \`${action.gate_id || 'unknown'}\` (${action.gate_type || 'unknown'}) action ${action.action_index || '?'} — **${action.status}** at \`${action.timestamp || 'n/a'}\`: ${label} (exit \`${exit}\`)`);
+        const mdTimeout = action.timed_out ? ` ⏱ timed out after ${action.timeout_ms}ms` : '';
+        lines.push(`- \`${action.gate_id || 'unknown'}\` (${action.gate_type || 'unknown'}) action ${action.action_index || '?'} — **${action.status}** at \`${action.timestamp || 'n/a'}\`: ${label} (exit \`${exit}\`)${mdTimeout}`);
         if (action.stderr_tail) {
           lines.push(`  - stderr: ${action.stderr_tail}`);
         }
@@ -2723,7 +2725,8 @@ function renderRunHtml(report) {
     for (const action of run.gate_actions) {
       const label = action.action_label || action.command || `action ${action.action_index || '?'}`;
       const exit = action.exit_code == null ? 'n/a' : String(action.exit_code);
-      gaHtml += `<li><code>${esc(action.gate_id || 'unknown')}</code> (${esc(action.gate_type || 'unknown')}) action ${esc(String(action.action_index || '?'))} — <strong>${esc(action.status)}</strong> at <code>${esc(action.timestamp || 'n/a')}</code>: ${esc(label)} (exit <code>${esc(exit)}</code>)`;
+      const htmlTimeout = action.timed_out ? ` <em>⏱ timed out after ${esc(String(action.timeout_ms))}ms</em>` : '';
+      gaHtml += `<li><code>${esc(action.gate_id || 'unknown')}</code> (${esc(action.gate_type || 'unknown')}) action ${esc(String(action.action_index || '?'))} — <strong>${esc(action.status)}</strong> at <code>${esc(action.timestamp || 'n/a')}</code>: ${esc(label)} (exit <code>${esc(exit)}</code>)${htmlTimeout}`;
       if (action.stderr_tail) {
         gaHtml += `<br><code>${esc(action.stderr_tail)}</code>`;
       }