Add user-friendly descriptions for PR tools (#8514)

* Initial plan

* Initial plan for fixing PR tool descriptions

Co-authored-by: alexr00 <38270282+alexr00@users.noreply.github.com>

* Add user-friendly descriptions for PR tools

Co-authored-by: alexr00 <38270282+alexr00@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: alexr00 <38270282+alexr00@users.noreply.github.com>

Author: Copilot

package.json

@@ -3782,6 +3782,7 @@
 				],
 				"toolReferenceName": "issue_fetch",
 				"displayName": "%languageModelTools.github-pull-request_issue_fetch.displayName%",
+				"userDescription": "%languageModelTools.github-pull-request_issue_fetch.description%",
 				"modelDescription": "Get a GitHub issue/PR's details as a JSON object.",
 				"icon": "$(info)",
 				"canBeReferencedInPrompt": true,
@@ -3825,7 +3826,8 @@
 				],
 				"toolReferenceName": "labels_fetch",
 				"displayName": "%languageModelTools.github-pull-request_labels_fetch.displayName%",
-				"modelDescription": "Fetch all labels from a GitHub repository. Returns the label names, colors, and descriptions.",
+				"userDescription": "%languageModelTools.github-pull-request_labels_fetch.description%",
+				"modelDescription": "Fetch all labels from a GitHub repository. Returns the label names, colors, and descriptions as a JSON object.",
 				"icon": "$(tag)",
 				"canBeReferencedInPrompt": true,
 				"inputSchema": {
@@ -3861,6 +3863,7 @@
 				],
 				"toolReferenceName": "notification_fetch",
 				"displayName": "%languageModelTools.github-pull-request_notification_fetch.displayName%",
+				"userDescription": "%languageModelTools.github-pull-request_notification_fetch.description%",
 				"modelDescription": "Get a GitHub notification's details as a JSON object.",
 				"icon": "$(info)",
 				"canBeReferencedInPrompt": true,
@@ -3887,6 +3890,7 @@
 				],
 				"toolReferenceName": "doSearch",
 				"displayName": "%languageModelTools.github-pull-request_doSearch.displayName%",
+				"userDescription": "%languageModelTools.github-pull-request_doSearch.description%",
 				"modelDescription": "Execute a GitHub search given a well formed GitHub search query. Make sure to form a good search query first",
 				"icon": "$(search)",
 				"canBeReferencedInPrompt": true,

package.nls.json

@@ -421,13 +421,17 @@
 	"welcome.issues.github.noRepo.contents": "No git repositories found",
 	"welcome.github.activePullRequest.contents": "Loading...",
 	"languageModelTools.github-pull-request_issue_fetch.displayName": "Get a GitHub Issue or pull request",
+	"languageModelTools.github-pull-request_issue_fetch.description": "Get the details of a GitHub issue or pull request.",
 	"languageModelTools.github-pull-request_issue_summarize.displayName": "Summarize a GitHub Issue or pull request",
 	"languageModelTools.github-pull-request_labels_fetch.displayName": "Fetch labels from a GitHub repository",
+	"languageModelTools.github-pull-request_labels_fetch.description": "Fetch all labels from a GitHub repository, including their names, colors, and descriptions.",
 	"languageModelTools.github-pull-request_notification_fetch.displayName": "Get a GitHub Notification",
+	"languageModelTools.github-pull-request_notification_fetch.description": "Get the details of a GitHub notification.",
 	"languageModelTools.github-pull-request_notification_summarize.displayName": "Summarize a GitHub Notification",
 	"languageModelTools.github-pull-request_suggest-fix.displayName": "Suggest a Fix for a GitHub Issue",
 	"languageModelTools.github-pull-request_formSearchQuery.displayName": "Convert natural language to a GitHub search query",
 	"languageModelTools.github-pull-request_doSearch.displayName": "Execute a GitHub search",
+	"languageModelTools.github-pull-request_doSearch.description": "Search for GitHub issues and pull requests.",
 	"languageModelTools.github-pull-request_renderIssues.displayName": "Render issue items in a markdown table",
 	"languageModelTools.github-pull-request_activePullRequest.displayName": "Active Pull Request",
 	"languageModelTools.github-pull-request_activePullRequest.description": "Get information about the active GitHub pull request. This information includes: comments, files changed, pull request title + description, pull request state, and pull request status checks/CI.",