Function buildEngineFailureContext

actions/setup/js/handle_agent_failure.cjs:2294–2493

* Extract terminal error messages from agent-stdio.log to surface engine failures. * First tries to match known error patterns (ERROR:, Error:, Fatal:, panic:, Reconnecting...). * Falls back to the last non-empty lines of the log when no patterns match, so that * even timeout or unexpected-termin

(options = {})

 * @returns {string} Formatted context string, or empty string if no engine failure found
 */
function buildEngineFailureContext(options = {}) {
  const suppressEngineRateLimit429 = options.suppressEngineRateLimit429 === true;
  // Derive agent-stdio.log path from the agent output file path (same directory)
  const agentOutputFile = process.env.GH_AW_AGENT_OUTPUT;
  const stdioLogPath = agentOutputFile ? path.join(path.dirname(agentOutputFile), "agent-stdio.log") : "/tmp/gh-aw/agent-stdio.log";

  // Include engine ID in failure messages when available (e.g. "copilot", "claude", "codex")
  const engineId = process.env.GH_AW_ENGINE_ID || "";
  const engineLabel = engineId ? ` \`${engineId}\`` : " AI";

  try {
    if (!fs.existsSync(stdioLogPath)) {
      core.info(`agent-stdio.log not found at ${stdioLogPath}, skipping engine failure context`);
      return "";
    }

    const logContent = fs.readFileSync(stdioLogPath, "utf8");
    if (!logContent.trim()) {
      return "";
    }

    const lines = logContent.split("\n");

    // Guard: if the agent completed successfully (terminal_reason: "completed"), the job
    // failure was caused by something other than the agent itself (e.g., post-processing
    // or infrastructure). Suppress the engine failure context to avoid false positive labels.
    // Use the already-loaded logContent directly to avoid a redundant file read.
    if (/"terminal_reason"[ ]?:[ ]?"completed"/.test(logContent)) {
      core.info("Agent completed successfully (terminal_reason: completed) — suppressing engine failure context");
      return "";
    }

    if (!suppressEngineRateLimit429 && (hasEngineRateLimit429Signal(logContent) || hasEngineRateLimit429InOTELMirror())) {
      core.info("Detected engine HTTP 429/rate-limit signal — using dedicated context message");
      return buildEngineRateLimit429Context(engineLabel);
    }

    if (hasEngineMaxRunsExceededSignal(logContent)) {
      core.info("Detected engine max-runs guardrail signal — using dedicated context message");
      return buildEngineMaxRunsExceededContext(engineLabel);
    }

    const errorMessages = new Set();

    for (const line of lines) {
      // Codex / generic CLI: "ERROR: <message>" at the start of a line
      const errorPrefixMatch = line.match(/^ERROR:\s*(.+)$/);
      if (errorPrefixMatch) {
        errorMessages.add(errorPrefixMatch[1].trim());
        continue;
      }

      // Node.js / generic: "Error: <message>" at the start of a line
      const errorCapMatch = line.match(/^Error:\s*(.+)$/);
      if (errorCapMatch) {
        errorMessages.add(errorCapMatch[1].trim());
        continue;
      }