Function buildAwContext

actions/setup/js/aw_context.cjs:248–358

* Builds the aw_context object that identifies the calling workflow run. * This metadata is injected into dispatched workflows that declare an * aw_context input, allowing them to trace back to their caller and * resolve the current item (issue, pull request, discussion, check, etc.) * that trig

()

 *     `false` in all other cases.
 */
function buildAwContext() {
  const { item_type, item_number, comment_id, comment_node_id } = resolveItemContext(context.payload);
  const workflowRef = process.env.GITHUB_WORKFLOW_REF ?? "";
  const currentRepo = `${context.repo.owner}/${context.repo.repo}`;
  const currentRunId = String(process.env.GITHUB_RUN_ID ?? context.runId ?? "");
  const currentRunAttempt = String(process.env.GITHUB_RUN_ATTEMPT ?? "1");
  const currentHopId = buildWorkflowCallId(currentRunId, currentRunAttempt, workflowRef);
  const inheritedContext = readInboundAwContext(context.payload);
  const inheritedHopId = typeof inheritedContext?.hop_id === "string" ? inheritedContext.hop_id.trim() : typeof inheritedContext?.workflow_call_id === "string" ? inheritedContext.workflow_call_id.trim() : "";
  const parentHopId = typeof inheritedContext?.parent_hop_id === "string" && inheritedContext.parent_hop_id.trim() ? inheritedContext.parent_hop_id.trim() : inheritedHopId;
  const episodeId = typeof inheritedContext?.episode_id === "string" && inheritedContext.episode_id.trim() ? inheritedContext.episode_id.trim() : inheritedHopId || currentHopId;
  const originEvent =
    typeof inheritedContext?.origin_event === "string" && inheritedContext.origin_event.trim()
      ? inheritedContext.origin_event.trim()
      : typeof inheritedContext?.event_type === "string" && inheritedContext.event_type.trim()
        ? inheritedContext.event_type.trim()
        : (context.eventName ?? "");
  const rootRepo =
    typeof inheritedContext?.root_repo === "string" && inheritedContext.root_repo.trim()
      ? inheritedContext.root_repo.trim()
      : typeof inheritedContext?.repo === "string" && inheritedContext.repo.trim()
        ? inheritedContext.repo.trim()
        : currentRepo;
  const rootWorkflowId =
    typeof inheritedContext?.root_workflow_id === "string" && inheritedContext.root_workflow_id.trim()
      ? inheritedContext.root_workflow_id.trim()
      : typeof inheritedContext?.workflow_id === "string" && inheritedContext.workflow_id.trim()
        ? inheritedContext.workflow_id.trim()
        : workflowRef;
  const rootRunId =
    typeof inheritedContext?.root_run_id === "string" && inheritedContext.root_run_id.trim()
      ? inheritedContext.root_run_id.trim()
      : typeof inheritedContext?.run_id === "string" && inheritedContext.run_id.trim()
        ? inheritedContext.run_id.trim()
        : currentRunId;
  const assignments = readExperimentAssignments();
  const experimentAssignments = assignments ? JSON.stringify(assignments) : "";

  // Compute allow_bot_authored_trigger_comment ahead of the object.
  // True when the triggering event is issue_comment:edited, the comment was authored
  // by a GitHub App bot (login ends with "[bot]"), and the editor (actor) differs from
  // the comment author — the bot-posted-menu / user-checks-box pattern.
  const isIssueCommentEdited = context.eventName === "issue_comment" && context.payload?.action === "edited";
  const triggerCommentAuthor = context.payload?.comment?.user?.login;
  const triggerCommentByBot = typeof triggerCommentAuthor === "string" && triggerCommentAuthor.endsWith("[bot]");
  const allowBotAuthoredTriggerComment = isIssueCommentEdited && triggerCommentByBot && triggerCommentAuthor !== (context.actor ?? "");

  return {
    repo: currentRepo,
    run_id: String(context.runId ?? ""),
    run_attempt: currentRunAttempt,
    // GITHUB_WORKFLOW_REF provides the full workflow file path including the ref,
    // e.g. "owner/repo/.github/workflows/dispatcher.yml@refs/heads/main"
    workflow_id: workflowRef,
    // episode_id identifies the full automation session across workflow hops.
    episode_id: episodeId,
    // hop_id uniquely identifies this specific workflow invocation.
    hop_id: currentHopId,