Migrate list_issues tool from REST to GraphQL API (#833)

* initial changes

* Further advances on list_issues tool to use GRPC

* Updating pagination for Graphql ListIssues

* Sorting data structures & returning mapped Issue

* Adding dynamic label queries

* Adding dynamic state queries for list_issues

* Add optional since filter, to get issues based on last update to issue

* Move ListIssues test to graphql format & removal of temp file

* Update documentation and fix linter issues

* Removal of redundant code, and increase limit on label return

* Fixing context for status to allow for better interactions

* Update tool snaps with tool description

* Update docs for final changes to context

Author: MattBabbage

README.md

@@ -539,15 +539,15 @@ The following sets of tools are available (all are on by default):
   - `repo`: Repository name (string, required)
 
 - **list_issues** - List issues
-  - `direction`: Sort direction (string, optional)
+  - `after`: Cursor for pagination. Use the endCursor from the previous page's PageInfo for GraphQL APIs. (string, optional)
+  - `direction`: Order direction. If provided, the 'orderBy' also needs to be provided. (string, optional)
   - `labels`: Filter by labels (string[], optional)
+  - `orderBy`: Order issues by field. If provided, the 'direction' also needs to be provided. (string, optional)
   - `owner`: Repository owner (string, required)
-  - `page`: Page number for pagination (min 1) (number, optional)
   - `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
   - `repo`: Repository name (string, required)
   - `since`: Filter by date (ISO 8601 timestamp) (string, optional)
-  - `sort`: Sort order (string, optional)
-  - `state`: Filter by state (string, optional)
+  - `state`: Filter by state, by default both open and closed issues are returned when not provided (string, optional)
 
 - **list_sub_issues** - List sub-issues
   - `issue_number`: Issue number (number, required)

pkg/github/__toolsnaps__/list_issues.snap

@@ -3,14 +3,18 @@
     "title": "List issues",
     "readOnlyHint": true
   },
-  "description": "List issues in a GitHub repository.",
+  "description": "List issues in a GitHub repository. For pagination, use the 'endCursor' from the previous response's 'pageInfo' in the 'after' parameter.",
   "inputSchema": {
     "properties": {
+      "after": {
+        "description": "Cursor for pagination. Use the endCursor from the previous page's PageInfo for GraphQL APIs.",
+        "type": "string"
+      },
       "direction": {
-        "description": "Sort direction",
+        "description": "Order direction. If provided, the 'orderBy' also needs to be provided.",
         "enum": [
-          "asc",
-          "desc"
+          "ASC",
+          "DESC"
         ],
         "type": "string"
       },
@@ -21,15 +25,18 @@
         },
         "type": "array"
       },
+      "orderBy": {
+        "description": "Order issues by field. If provided, the 'direction' also needs to be provided.",
+        "enum": [
+          "CREATED_AT",
+          "UPDATED_AT"
+        ],
+        "type": "string"
+      },
       "owner": {
         "description": "Repository owner",
         "type": "string"
       },
-      "page": {
-        "description": "Page number for pagination (min 1)",
-        "minimum": 1,
-        "type": "number"
-      },
       "perPage": {
         "description": "Results per page for pagination (min 1, max 100)",
         "maximum": 100,
@@ -44,21 +51,11 @@
         "description": "Filter by date (ISO 8601 timestamp)",
         "type": "string"
       },
-      "sort": {
-        "description": "Sort order",
-        "enum": [
-          "created",
-          "updated",
-          "comments"
-        ],
-        "type": "string"
-      },
       "state": {
-        "description": "Filter by state",
+        "description": "Filter by state, by default both open and closed issues are returned when not provided",
         "enum": [
-          "open",
-          "closed",
-          "all"
+          "OPEN",
+          "CLOSED"
         ],
         "type": "string"
       }