Merge branch 'main' into teams-tool

Author: mattdholloway

README.md

@@ -542,15 +542,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)
@@ -575,11 +575,11 @@ The following sets of tools are available (all are on by default):
 
 - **search_issues** - Search issues
   - `order`: Sort order (string, optional)
-  - `owner`: Optional repository owner. If provided with repo, only notifications for this repository are listed. (string, optional)
+  - `owner`: Optional repository owner. If provided with repo, only issues for this repository are listed. (string, optional)
   - `page`: Page number for pagination (min 1) (number, optional)
   - `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
   - `query`: Search query using GitHub issues search syntax (string, required)
-  - `repo`: Optional repository name. If provided with owner, only notifications for this repository are listed. (string, optional)
+  - `repo`: Optional repository name. If provided with owner, only issues for this repository are listed. (string, optional)
   - `sort`: Sort field by number of matches of categories, defaults to best match (string, optional)
 
 - **update_issue** - Edit issue
@@ -747,11 +747,11 @@ The following sets of tools are available (all are on by default):
 
 - **search_pull_requests** - Search pull requests
   - `order`: Sort order (string, optional)
-  - `owner`: Optional repository owner. If provided with repo, only notifications for this repository are listed. (string, optional)
+  - `owner`: Optional repository owner. If provided with repo, only pull requests for this repository are listed. (string, optional)
   - `page`: Page number for pagination (min 1) (number, optional)
   - `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
   - `query`: Search query using GitHub pull request search syntax (string, required)
-  - `repo`: Optional repository name. If provided with owner, only notifications for this repository are listed. (string, optional)
+  - `repo`: Optional repository name. If provided with owner, only pull requests for this repository are listed. (string, optional)
   - `sort`: Sort field by number of matches of categories, defaults to best match (string, optional)
 
 - **submit_pending_pull_request_review** - Submit the requester's latest pending pull request review

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"
       }

pkg/github/__toolsnaps__/search_issues.snap

@@ -15,7 +15,7 @@
         "type": "string"
       },
       "owner": {
-        "description": "Optional repository owner. If provided with repo, only notifications for this repository are listed.",
+        "description": "Optional repository owner. If provided with repo, only issues for this repository are listed.",
         "type": "string"
       },
       "page": {
@@ -34,7 +34,7 @@
         "type": "string"
       },
       "repo": {
-        "description": "Optional repository name. If provided with owner, only notifications for this repository are listed.",
+        "description": "Optional repository name. If provided with owner, only issues for this repository are listed.",
         "type": "string"
       },
       "sort": {

pkg/github/__toolsnaps__/search_pull_requests.snap

@@ -15,7 +15,7 @@
         "type": "string"
       },
       "owner": {
-        "description": "Optional repository owner. If provided with repo, only notifications for this repository are listed.",
+        "description": "Optional repository owner. If provided with repo, only pull requests for this repository are listed.",
         "type": "string"
       },
       "page": {
@@ -34,7 +34,7 @@
         "type": "string"
       },
       "repo": {
-        "description": "Optional repository name. If provided with owner, only notifications for this repository are listed.",
+        "description": "Optional repository name. If provided with owner, only pull requests for this repository are listed.",
         "type": "string"
       },
       "sort": {