actions.tsp

import "@typespec/http";
import "@microsoft/typespec-m365-copilot";

using TypeSpec.Http;
using TypeSpec.M365.Copilot.Actions;

@service
@server(GitHubAPI.SERVER_URL)
@actions(GitHubAPI.ACTIONS_METADATA)
namespace GitHubAPI {
  /**
   * Metadata for the GitHub API actions.
   */
  const ACTIONS_METADATA = #{
    nameForHuman: "GitHub",
    descriptionForHuman: "Search open issues on GitHub.",
    descriptionForModel: "Search open issues from GitHub repositories.",
    legalInfoUrl: "https://docs.github.com/en/site-policy/github-terms/github-terms-of-service",
    privacyPolicyUrl: "https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement"
  };
  
  /**
   * The base URL for the GitHub API.
   */
  const SERVER_URL = "https://api.github.com";

  /**
   * Search open issues from GitHub repositories.
   * @param q The search query.
   * @param per_page The number of results per page. Default is 5.
   */
  @route("/search/issues")
  @card(#{ dataPath: "$.items", title: "$.title", url: "$.html_url", file: "adaptiveCards/searchIssues.json" })
  @get op searchIssues(
    @query q: string = "repo:\${{GITHUB_REPO}} is:issue is:open", 
    @query per_page: integer = 5
  ): string;
}