Function buildAssignmentErrorsContext

actions/setup/js/handle_agent_failure.cjs:2093–2119

* Build a context string when assign_to_agent reported assignment errors. * Includes remediation guidance for token and Copilot access setup. * @param {string} assignmentErrors * @returns {string}

(assignmentErrors)

 * @returns {string}
 */
function buildAssignmentErrorsContext(assignmentErrors) {
  if (!assignmentErrors || !assignmentErrors.trim()) {
    return "";
  }

  let context = buildWarningAlertLine("Agent Assignment Failed", "Failed to assign agent to issues or pull requests.");
  context += "\n**Assignment Errors:**\n";

  const errorLines = assignmentErrors.split("\n").filter(line => line.trim());
  for (const errorLine of errorLines) {
    const parts = errorLine.split(":");
    if (parts.length >= 4) {
      const type = parts[0]; // "issue" or "pr"
      const number = parts[1];
      const agent = parts[2];
      const error = parts.slice(3).join(":");
      context += `- ${type === "issue" ? "Issue" : "PR"} #${number} (agent: ${agent}): ${error}\n`;
    }
  }

  context += "\nTo resolve this, verify the agent token and Copilot access configuration:\n";
  context += "- Configure a valid `GH_AW_AGENT_TOKEN` as a fine-grained PAT with **Agent tasks: read and write** permission (GitHub App installation tokens are not supported)\n";
  context += "- Ensure Copilot coding agent is enabled for this repository and a Copilot Business or Enterprise subscription is active\n";
  context += "- Docs: https://github.github.com/gh-aw/reference/copilot-cloud-agent/#authentication\n\n";

  return context;
}
/**
 * Build a context string when assigning the Copilot coding agent to created issues failed.
 * @param {boolean} hasAssignCopilotFailures - Whether any copilot assignments failed