githubSearchCode

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: +"Extension without dot (ts, js, py)"

Added value: +"Filename pattern (case-insensitive)"

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: +"Search terms (1-5, AND logic). match=file returns text_matches[]"

Added value: +"Max results (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: +"\"file\" (content) | \"path\" (names). Omit for both"

Added value: +"Repo owner (omit for cross-repo)"

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

Added value: +"Directory path (strict prefix match)"

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

Added value: +"Repo name (use with owner)"

Added value: +"Specific information this query seeks"

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

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": {
+                  "files": {
+                    "description": "Matching files with repository context and snippets",
+                    "items": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "lastModifiedAt": {
+                          "description": "Last modified timestamp for the file",
+                          "type": "string"
+                        },
+                        "owner": {
+                          "description": "Repository owner",
+                          "type": "string"
+                        },
+                        "path": {
+                          "description": "Path of the matching file in the repository",
+                          "type": "string"
+                        },
+                        "repo": {
+                          "description": "Repository name",
+                          "type": "string"
+                        },
+                        "text_matches": {
+                          "description": "Matched code snippets when searching file content",
+                          "items": {
+                            "anyOf": [
+                              {
+                                "type": "string"
+                              },
+                              {
+                                "additionalProperties": false,
+                                "properties": {
+                                  "matchIndices": {
+                                    "description": "Character offset positions of matches within the snippet",
+                                    "items": {
+                                      "additionalProperties": false,
+                                      "properties": {
+                                        "end": {
+                                          "description": "End offset of match",
+                                          "maximum": 9007199254740991,
+                                          "minimum": 0,
+                                          "type": "integer"
+                                        },
+                                        "start": {
+                                          "description": "Start offset of match",
+                                          "maximum": 9007199254740991,
+                                          "minimum": 0,
+                                          "type": "integer"
+                                        }
+                                      },
+                                      "required": [
+                                        "start",
+                                        "end"
+                                      ],
+                                      "type": "object"
+                                    },
+                                    "type": "array"
+                                  },
+                                  "value": {
+                                    "description": "Matched code snippet context",
+                                    "type": "string"
+                                  }
+                                },
+                                "required": [
+                                  "value"
+                                ],
+                                "type": "object"
+                              }
+                            ]
+                          },
+                          "type": "array"
+                        }
+                      },
+                      "required": [
+                        "path"
+                      ],
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "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 search 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"
+                  },
+                  "repositoryContext": {
+                    "additionalProperties": false,
+                    "description": "Repository context metadata for single-repository searches",
+                    "properties": {
+                      "branch": {
+                        "description": "Default branch of the repository",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "branch"
+                    ],
+                    "type": "object"
+                  }
+                },
+                "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 githubSearchCode (1-3 queries per call for optimal resource management). Review schema before use for optimal results"

Removed value: -"File extension filter"

Removed value: -"Target specific filename or pattern"

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

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "maxItems": 5,
+  "minItems": 1,
+  "type": "array"
+}

Removed value: -{
-  "description": "Programming language filter",
-  "type": "string"
-}

Added value: +10

Removed value: -"Maximum results per query (1-100)"

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

Removed value: -"Search scope: file (content) or path (filenames)"

Removed value: -{
-  "default": true,
-  "description": "Optimize content for token efficiency (enabled by default). Removes excessive whitespace and comments. Set to false only when exact formatting is required.",
-  "type": "boolean"
-}

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

Removed value: -"Repository owner/organization name"

Added value: +"string"

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

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

Removed value: -{
-  "description": "Search terms with AND logic - ALL terms must be present in same file. Use sparingly: single terms get broader results, multiple terms are restrictive.",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

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

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

Removed value: -"Repository name (use with owner for specific repo)"

Added value: +"string"

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

Removed value: -{
-  "default": true,
-  "description": "Sanitize content for security (enabled by default). Removes potential secrets and malicious content. Set to false only when raw content is required.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "File size filter in KB",
-  "pattern": "^(>=?\\d+|<=?\\d+|\\d+\\.\\.\\d+|\\d+)$",
-  "type": "string"
-}

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

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

Previous value: -5New value: +3