githubSearchRepositories

Removed value: -false

Added value: +{
+  "description": "Character budget for output pagination after domain pagination has been applied.",
+  "maximum": 50000,
+  "minimum": 1,
+  "type": "integer"
+}

Added value: +{
+  "description": "Character offset for output pagination after domain pagination has been applied.",
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +"Date: \">=YYYY-MM-DD\" or \"YYYY-MM-DD..YYYY-MM-DD\""

Added value: +{
+  "description": "Stable query identifier used to match each result to its input query. Required for every query. Use a short meaningful string like \"react_hooks_search\" or \"router_prs\".",
+  "maxLength": 120,
+  "minLength": 1,
+  "pattern": "^[A-Za-z0-9._:-]+$",
+  "type": "string"
+}

Added value: +"Keywords (AND logic) across name, description, README"

Added value: +"Max repos (1-100). Default: 10"

Added value: +"Main research objective (multiple queries can share the same main goal for semantic grouping and session tracking)"

Added value: +"[\"name\"|\"description\"|\"readme\"]. Very restrictive"

Added value: +"Repo owner/org to scope results"

Added value: +"Page (1-10). Default: 1"

Added value: +"Why this query helps achieve the goal"

Added value: +"Specific information this query seeks"

Added value: +"Repo size in KB with operators"

Added value: +"stars | forks | updated | best-match"

Added value: +"Stars filter: \">500\", \"100..500\""

Added value: +"GitHub topic tags"

Added value: +"Last metadata update (not code pushes)"

Previous value: -[
-  "mainResearchGoal",
-  "researchGoal",
-  "reasoning"
-]New value: +[
+  "id",
+  "mainResearchGoal",
+  "researchGoal",
+  "reasoning"
+]

Added value: +{
+  "description": "Character budget for top-level bulk response pagination across results[]. Overrides the shared default for this call.",
+  "maximum": 50000,
+  "minimum": 1,
+  "type": "integer"
+}

Added value: +{
+  "description": "Character offset for top-level bulk response pagination across results[]. Use when a multi-query response was auto-paginated.",
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "responsePagination": {
+      "additionalProperties": false,
+      "description": "Pagination metadata for top-level bulk response pagination across results[]",
+      "properties": {
+        "charLength": {
+          "description": "Character length of the current page",
+          "maximum": 9007199254740991,
+          "minimum": 0,
+          "type": "integer"
+        },
+        "charOffset": {
+          "description": "Character offset of the current page",
+          "maximum": 9007199254740991,
+          "minimum": 0,
+          "type": "integer"
+        },
+        "currentPage": {
+          "description": "Current page number (1-indexed)",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "type": "integer"
+        },
+        "hasMore": {
+          "description": "Whether more pages are available after the current page",
+          "type": "boolean"
+        },
+        "totalChars": {
+          "description": "Total number of characters in the full output",
+          "maximum": 9007199254740991,
+          "minimum": 0,
+          "type": "integer"
+        },
+        "totalPages": {
+          "description": "Total number of pages available",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "currentPage",
+        "totalPages",
+        "hasMore",
+        "charOffset",
+        "charLength",
+        "totalChars"
+      ],
+      "type": "object"
+    },
+    "results": {
+      "description": "Array of results, one per input query, discriminated by status",
+      "items": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "data": {
+                "additionalProperties": false,
+                "description": "The tool-specific result data",
+                "properties": {
+                  "hints": {
+                    "description": "Contextual hints and suggestions for next steps or better queries",
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "outputPagination": {
+                    "additionalProperties": false,
+                    "description": "Payload pagination metadata when the result body was size-paginated",
+                    "properties": {
+                      "charLength": {
+                        "description": "Character length of the current page",
+                        "maximum": 9007199254740991,
+                        "minimum": 0,
+                        "type": "integer"
+                      },
+                      "charOffset": {
+                        "description": "Character offset of the current page",
+                        "maximum": 9007199254740991,
+                        "minimum": 0,
+                        "type": "integer"
+                      },
+                      "currentPage": {
+                        "description": "Current page number (1-indexed)",
+                        "exclusiveMinimum": 0,
+                        "maximum": 9007199254740991,
+                        "type": "integer"
+                      },
+                      "hasMore": {
+                        "description": "Whether more pages are available after the current page",
+                        "type": "boolean"
+                      },
+                      "totalChars": {
+                        "description": "Total number of characters in the full output",
+                        "maximum": 9007199254740991,
+                        "minimum": 0,
+                        "type": "integer"
+                      },
+                      "totalPages": {
+                        "description": "Total number of pages available",
+                        "exclusiveMinimum": 0,
+                        "maximum": 9007199254740991,
+                        "type": "integer"
+                      }
+                    },
+                    "required": [
+                      "currentPage",
+                      "totalPages",
+                      "hasMore",
+                      "charOffset",
+                      "charLength",
+                      "totalChars"
+                    ],
+                    "type": "object"
+                  },
+                  "pagination": {
+                    "additionalProperties": false,
+                    "description": "Pagination info for navigating through repository results",
+                    "properties": {
+                      "currentPage": {
+                        "description": "Current page number (1-indexed)",
+                        "exclusiveMinimum": 0,
+                        "maximum": 9007199254740991,
+                        "type": "integer"
+                      },
+                      "hasMore": {
+                        "description": "Whether more pages are available after the current page",
+                        "type": "boolean"
+                      },
+                      "perPage": {
+                        "description": "Results returned per page",
+                        "exclusiveMinimum": 0,
+                        "maximum": 9007199254740991,
+                        "type": "integer"
+                      },
+                      "totalMatches": {
+                        "description": "Total matching results across all pages",
+                        "maximum": 9007199254740991,
+                        "minimum": 0,
+                        "type": "integer"
+                      },
+                      "totalPages": {
+                        "description": "Total number of pages available",
+                        "exclusiveMinimum": 0,
+                        "maximum": 9007199254740991,
+                        "type": "integer"
+                      }
+                    },
+                    "required": [
+                      "currentPage",
+                      "totalPages",
+                      "hasMore",
+                      "perPage",
+                      "totalMatches"
+                    ],
+                    "type": "object"
+                  },
+                  "repositories": {
+                    "description": "Matching repositories",
+                    "items": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "createdAt": {
+                          "description": "Creation timestamp",
+                          "type": "string"
+                        },
+                        "defaultBranch": {
+                          "description": "Default branch of the repository",
+                          "type": "string"
+                        },
+                        "description": {
+                          "description": "Repository description",
+                          "type": "string"
+                        },
+                        "forksCount": {
+                          "description": "Fork count",
+                          "maximum": 9007199254740991,
+                          "minimum": 0,
+                          "type": "integer"
+                        },
+                        "language": {
+                          "description": "Primary programming language of the repository",
+                          "type": "string"
+                        },
+                        "openIssuesCount": {
+                          "description": "Open issues count",
+                          "maximum": 9007199254740991,
+                          "minimum": 0,
+                          "type": "integer"
+                        },
+                        "owner": {
+                          "description": "Repository owner",
+                          "type": "string"
+                        },
+                        "pushedAt": {
+                          "description": "Last push timestamp",
+                          "type": "string"
+                        },
+                        "repo": {
+                          "description": "Repository name",
+                          "type": "string"
+                        },
+                        "stars": {
+                          "description": "Star count",
+                          "maximum": 9007199254740991,
+                          "minimum": 0,
+                          "type": "integer"
+                        },
+                        "topics": {
+                          "description": "Repository topics",
+                          "items": {
+                            "type": "string"
+                          },
+                          "type": "array"
+                        },
+                        "updatedAt": {
+                          "description": "Last update timestamp",
+                          "type": "string"
+                        },
+                        "url": {
+                          "description": "Web URL for the repository",
+                          "type": "string"
+                        },
+                        "visibility": {
+                          "description": "Repository visibility",
+                          "enum": [
+                            "public",
+                            "private",
+                            "internal"
+                          ],
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "owner",
+                        "repo",
+                        "stars",
+                        "description",
+                        "url",
+                        "createdAt",
+                        "updatedAt",
+                        "pushedAt"
+                      ],
+                      "type": "object"
+                    },
+                    "type": "array"
+                  }
+                },
+                "required": [
+                  "repositories"
+                ],
+                "type": "object"
+              },
+              "id": {
+                "description": "Stable query identifier matching the input query id",
+                "minLength": 1,
+                "type": "string"
+              },
+              "status": {
+                "const": "hasResults",
+                "description": "Indicates the query returned results successfully",
+                "type": "string"
+              }
+            },
+            "required": [
+              "id",
+              "status",
+              "data"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "data": {
+                "additionalProperties": {},
+                "description": "Empty result metadata (may contain hints or paging details)",
+                "properties": {},
+                "type": "object"
+              },
+              "id": {
+                "description": "Stable query identifier matching the input query id",
+                "minLength": 1,
+                "type": "string"
+              },
+              "status": {
+                "const": "empty",
+                "description": "Indicates the query returned no matching results",
+                "type": "string"
+              }
+            },
+            "required": [
+              "id",
+              "status",
+              "data"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "data": {
+                "additionalProperties": false,
+                "description": "Error details including message, type, and recovery hints",
+                "properties": {
+                  "cwd": {
+                    "description": "Working directory relevant to the error",
+                    "type": "string"
+                  },
+                  "error": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "additionalProperties": false,
+                        "properties": {
+                          "error": {
+                            "description": "GitHub API error message",
+                            "type": "string"
+                          },
+                          "hints": {
+                            "description": "Provider-specific hints",
+                            "items": {
+                              "type": "string"
+                            },
+                            "type": "array"
+                          },
+                          "rateLimitRemaining": {
+                            "description": "Remaining API requests in the current rate limit window",
+                            "type": "number"
+                          },
+                          "rateLimitReset": {
+                            "description": "Rate limit reset time in milliseconds since epoch",
+                            "type": "number"
+                          },
+                          "retryAfter": {
+                            "description": "Retry-after delay in seconds",
+                            "type": "number"
+                          },
+                          "scopesSuggestion": {
+                            "description": "Suggested scopes needed to resolve the error",
+                            "type": "string"
+                          },
+                          "status": {
+                            "description": "HTTP status code",
+                            "maximum": 9007199254740991,
+                            "minimum": -9007199254740991,
+                            "type": "integer"
+                          },
+                          "type": {
+                            "description": "GitHub API error category",
+                            "enum": [
+                              "http",
+                              "graphql",
+                              "network",
+                              "unknown"
+                            ],
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "error",
+                          "type"
+                        ],
+                        "type": "object"
+                      }
+                    ],
+                    "description": "Error message or API error object"
+                  },
+                  "errorCode": {
+                    "description": "Tool error code",
+                    "type": "string"
+                  },
+                  "errorType": {
+                    "description": "Tool-specific error type (e.g. symbol_not_found, size_limit)",
+                    "type": "string"
+                  },
+                  "hints": {
+                    "description": "Recovery hints",
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "resolvedPath": {
+                    "description": "Resolved filesystem path involved in the error",
+                    "type": "string"
+                  },
+                  "searchRadius": {
+                    "description": "LSP search radius when symbol not found",
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "error"
+                ],
+                "type": "object"
+              },
+              "id": {
+                "description": "Stable query identifier matching the input query id",
+                "minLength": 1,
+                "type": "string"
+              },
+              "status": {
+                "const": "error",
+                "description": "Indicates the query encountered an error",
+                "type": "string"
+              }
+            },
+            "required": [
+              "id",
+              "status",
+              "data"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "results"
+  ],
+  "type": "object"
+}

Previous value: -"Array of up to 5 different search queries for parallel execution"New value: +"Research queries for githubSearchRepositories (1-3 queries per call for optimal resource management). Review schema before use for optimal results"

Removed value: -{
-  "description": "Archive status filter. false (active repos only), true (archived repos only).",
-  "type": [
-    "boolean",
-    "null"
-  ]
-}

Removed value: -[
-  {
-    "pattern": "^(>=?\\d{4}-\\d{2}-\\d{2}|<=?\\d{4}-\\d{2}-\\d{2}|\\d{4}-\\d{2}-\\d{2}\\.\\.\\d{4}-\\d{2}-\\d{2}|\\d{4}-\\d{2}-\\d{2})$",
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

Removed value: -"Repository creation date filter. Format: \">2020-01-01\" (after), \">=2020-01-01\" (on or after), \"<2023-12-31\" (before), \"<=2023-12-31\" (on or before), \"2020-01-01..2023-12-31\" (range), \"2023-01-01\" (exact)."

Added value: +"string"

Removed value: -{
-  "description": "Single exact phrase/word search",
-  "type": "string"
-}

Removed value: -{
-  "additionalProperties": {},
-  "description": "Fallback parameters if original query returns no results, overrides the original query and try again",
-  "type": "object"
-}

Removed value: -{
-  "anyOf": [
-    {
-      "minimum": 0,
-      "type": "integer"
-    },
-    {
-      "pattern": "^(>=?\\d+|<=?\\d+|\\d+\\.\\.\\d+|\\d+)$",
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "description": "Repository owner followers count. Format: \">1000\" (popular developers), \">=500\" (established developers), \"<100\" (smaller developers), \"100..1000\" (range)."
-}

Removed value: -{
-  "anyOf": [
-    {
-      "minimum": 0,
-      "type": "integer"
-    },
-    {
-      "pattern": "^(>=?\\d+|<=?\\d+|\\d+\\.\\.\\d+|\\d+)$",
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "description": "Fork count filter. Format: \">N\" (more than), \"<N\" (less than), \"N..M\" (range)."
-}

Removed value: -{
-  "anyOf": [
-    {
-      "minimum": 0,
-      "type": "integer"
-    },
-    {
-      "pattern": "^(>=?\\d+|<=?\\d+|\\d+\\.\\.\\d+|\\d+)$",
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "description": "Good first issues count. Format: \">5\" (many beginner issues), \"1..10\" (some beginner issues)."
-}

Removed value: -{
-  "anyOf": [
-    {
-      "minimum": 0,
-      "type": "integer"
-    },
-    {
-      "pattern": "^(>=?\\d+|<=?\\d+|\\d+\\.\\.\\d+|\\d+)$",
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "description": "Help wanted issues count. Format: \">10\" (many help wanted), \"1..5\" (some help wanted)."
-}

Removed value: -{
-  "description": "Optional identifier for the query",
-  "type": "string"
-}

Removed value: -{
-  "anyOf": [
-    {
-      "enum": [
-        "false",
-        "true",
-        "only"
-      ],
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "description": "Fork inclusion. \"false\" (exclude forks), \"true\" (include forks), \"only\" (forks only)."
-}

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Removed value: -{
-  "description": "Programming language filter. Filters repositories by primary language.",
-  "type": [
-    "string",
-    "null"
-  ]
-}

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "description": "License filter. Filter repositories by license type."
-}

Removed value: -[
-  {
-    "maximum": 100,
-    "minimum": 1,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +10

Removed value: -"Maximum number of repositories to return (1-100)."

Added value: +100

Added value: +1

Added value: +"integer"

Added value: +{
+  "type": "string"
+}

Removed value: -[
-  {
-    "enum": [
-      "name",
-      "description",
-      "readme"
-    ],
-    "type": "string"
-  },
-  {
-    "items": {
-      "enum": [
-        "name",
-        "description",
-        "readme"
-      ],
-      "type": "string"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]

Removed value: -"Search scope. Where to search: name, description, or readme content."

Added value: +{
+  "enum": [
+    "name",
+    "description",
+    "readme"
+  ],
+  "type": "string"
+}

Added value: +"array"

Removed value: -{
-  "anyOf": [
-    {
-      "minimum": 0,
-      "type": "integer"
-    },
-    {
-      "pattern": "^(>=?\\d+|<=?\\d+|\\d+\\.\\.\\d+|\\d+)$",
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "description": "Number of topics filter. Format: \">5\" (many topics), \">=3\" (at least 3), \"<10\" (few topics), \"1..3\" (range), \"5\" (exact)."
-}

Removed value: -{
-  "anyOf": [
-    {
-      "enum": [
-        "asc",
-        "desc"
-      ],
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "description": "Sort order direction."
-}

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]

Removed value: -"Repository owner/organization name(s). Search within specific organizations or users."

Added value: +"string"

Added value: +{
+  "default": 1,
+  "maximum": 10,
+  "minimum": 1,
+  "type": "integer"
+}

Removed value: -{
-  "description": "Multiple search terms for broader coverage",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

Added value: +{
+  "type": "string"
+}

Added value: +{
+  "type": "string"
+}

Removed value: -[
-  {
-    "pattern": "^(>=?\\d+|<=?\\d+|\\d+\\.\\.\\d+|\\d+)$",
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

Removed value: -"Repository size filter in KB. Format: \">1000\" (large projects), \">=500\" (medium-large), \"<100\" (small projects), \"<=50\" (tiny), \"100..1000\" (medium range), \"500\" (exact)."

Added value: +"string"

Removed value: -[
-  {
-    "enum": [
-      "forks",
-      "help-wanted-issues",
-      "stars",
-      "updated",
-      "best-match"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

Removed value: -"Sort criteria."

Added value: +[
+  "forks",
+  "stars",
+  "updated",
+  "best-match"
+]

Added value: +"string"

Removed value: -[
-  {
-    "minimum": 0,
-    "type": "integer"
-  },
-  {
-    "pattern": "^(>=?\\d+|<=?\\d+|\\d+\\.\\.\\d+|\\d+)$",
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

Removed value: -"Star count filter. Format: \">N\" (more than), \"<N\" (less than), \"N..M\" (range)."

Added value: +"string"

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "description": "Find repositories by technology/subject"
-}

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Removed value: -[
-  {
-    "pattern": "^(>=?\\d{4}-\\d{2}-\\d{2}|<=?\\d{4}-\\d{2}-\\d{2}|\\d{4}-\\d{2}-\\d{2}\\.\\.\\d{4}-\\d{2}-\\d{2}|\\d{4}-\\d{2}-\\d{2})$",
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

Removed value: -"Last updated date filter. Format: \">2024-01-01\" (recently updated), \">=2024-01-01\" (on or after), \"<2022-01-01\" (not recently updated), \"2023-01-01..2024-12-31\" (range)."

Added value: +"string"

Removed value: -{
-  "anyOf": [
-    {
-      "enum": [
-        "public",
-        "private",
-        "internal"
-      ],
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "description": "Repository visibility."
-}

Added value: +[
+  "mainResearchGoal",
+  "researchGoal",
+  "reasoning"
+]

Previous value: -5New value: +3