Sync eng/common directory with azure-sdk-tools for PR 15134 (#46334)

* Add GitHub Action run link to APIView PR comment

Agent-Logs-Url: https://github.com/Azure/azure-sdk-tools/sessions/0a4d8e3c-c96b-4265-905c-5f8918876354

Co-authored-by: raych1 <20296335+raych1@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Ray Chen <raychen@microsoft.com>

* Apply suggestion from @raych1

* Apply suggestion from @raych1

* Pass GitHubActionRunUrl via environment variable and use IsNullOrWhiteSpace guard

Agent-Logs-Url: https://github.com/Azure/azure-sdk-tools/sessions/61d68e76-9b14-444b-b244-44d770e9a9b2

Co-authored-by: raych1 <20296335+raych1@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: raych1 <20296335+raych1@users.noreply.github.com>
Co-authored-by: Ray Chen <raychen@microsoft.com>

Author: 3 people

eng/common/scripts/Helpers/ApiView-Helpers.ps1

@@ -127,7 +127,8 @@ function Set-ApiViewCommentForRelatedIssues {
     [string]$APIViewHost = "https://apiview.dev",
     [ValidateNotNullOrEmpty()]
     [Parameter(Mandatory = $true)]
-    $AuthToken
+    $AuthToken,
+    [string]$GitHubActionRunUrl = ""
   )
   . ${PSScriptRoot}\..\common.ps1
   $issuesForCommit = $null
@@ -144,7 +145,7 @@ function Set-ApiViewCommentForRelatedIssues {
   }
   $issuesForCommit.items | ForEach-Object {
     $urlParts = $_.url -split "/"
-    Set-ApiViewCommentForPR -RepoOwner $urlParts[4] -RepoName $urlParts[5] -PrNumber $urlParts[7] -HeadCommitish $HeadCommitish -APIViewHost $APIViewHost -AuthToken $AuthToken
+    Set-ApiViewCommentForPR -RepoOwner $urlParts[4] -RepoName $urlParts[5] -PrNumber $urlParts[7] -HeadCommitish $HeadCommitish -APIViewHost $APIViewHost -AuthToken $AuthToken -GitHubActionRunUrl $GitHubActionRunUrl
   }
 }
 
@@ -162,7 +163,8 @@ function Set-ApiViewCommentForPR {
     [string]$APIViewHost,
     [ValidateNotNullOrEmpty()]
     [Parameter(Mandatory = $true)]
-    $AuthToken
+    $AuthToken,
+    [string]$GitHubActionRunUrl = ""
   )
   $repoFullName = "$RepoOwner/$RepoName"
   $apiviewEndpoint = "$APIViewHost/api/pullrequests?pullRequestNumber=$PrNumber&repoName=$repoFullName&commitSHA=$HeadCommitish"
@@ -208,6 +210,11 @@ function Set-ApiViewCommentForPR {
   }
 
   $commentText += "<!-- Fetch URI: $apiviewEndpoint -->"
+  if (-not [string]::IsNullOrWhiteSpace($GitHubActionRunUrl)) {
+    $commentText += ""
+    $commentText += "---"
+    $commentText += "Comment generated by [After APIView]($GitHubActionRunUrl) workflow run."
+  }
   $commentText = $commentText -join "`r`n"
   $existingComment = $null;
   $existingAPIViewComment = $null;