githubGetFileContent

Removed value: -false

Added value: +"Branch/tag/SHA (optional, defaults to default branch)"

Added value: +"Max chars per page. Default: 20000"

Added value: +"Pagination offset. Default: 0"

Added value: +9007199254740991

Added value: +"End line (with startLine). File mode only"

Added value: +9007199254740991

Added value: +{
+  "default": false,
+  "description": "When true, bypass the cache and force a fresh fetch even if a valid cached copy exists. Only relevant for type \"directory\".",
+  "type": "boolean"
+}

Added value: +"Return entire file (default: false). File mode only"

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: +"Main research objective (multiple queries can share the same main goal for semantic grouping and session tracking)"

Added value: +"Search pattern to extract. File mode only"

Added value: +2000

Added value: +"Context around matches (1-50). Default: 5"

Added value: +"Repo owner"

Added value: +"File or directory path from root, no leading slash, exact case"

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

Added value: +"Repo name"

Added value: +"Specific information this query seeks"

Added value: +"Start line (with endLine). File mode only"

Added value: +9007199254740991

Added value: +{
+  "default": "file",
+  "description": "Choose ONE: \"file\" (default) returns content inline; \"directory\" saves all files to disk and returns localPath. Directory mode requires ENABLE_LOCAL=true and ENABLE_CLONE=true, and is only available with the GitHub provider (not GitLab).",
+  "enum": [
+    "file",
+    "directory"
+  ],
+  "type": "string"
+}

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

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": {
+                  "cached": {
+                    "description": "Whether a cached fetch was reused",
+                    "type": "boolean"
+                  },
+                  "content": {
+                    "description": "File content as text for single-file requests",
+                    "type": "string"
+                  },
+                  "endLine": {
+                    "description": "Ending line number of the returned content",
+                    "exclusiveMinimum": 0,
+                    "maximum": 9007199254740991,
+                    "type": "integer"
+                  },
+                  "fileCount": {
+                    "description": "Number of files fetched in directory mode",
+                    "maximum": 9007199254740991,
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  "files": {
+                    "description": "Files fetched in directory mode",
+                    "items": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "path": {
+                          "description": "Relative path within the fetched directory",
+                          "type": "string"
+                        },
+                        "size": {
+                          "description": "File size in bytes",
+                          "maximum": 9007199254740991,
+                          "minimum": 0,
+                          "type": "integer"
+                        },
+                        "type": {
+                          "const": "file",
+                          "description": "Directory fetch only returns files",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "path",
+                        "size",
+                        "type"
+                      ],
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "hints": {
+                    "description": "Contextual hints and suggestions for next steps or better queries",
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "isPartial": {
+                    "description": "Whether the returned file content is partial",
+                    "type": "boolean"
+                  },
+                  "lastModified": {
+                    "description": "Last modified timestamp for the file",
+                    "type": "string"
+                  },
+                  "lastModifiedBy": {
+                    "description": "Author of the last file modification",
+                    "type": "string"
+                  },
+                  "localPath": {
+                    "description": "Local filesystem path for directory fetch mode",
+                    "type": "string"
+                  },
+                  "pagination": {
+                    "additionalProperties": false,
+                    "description": "Pagination metadata for partial file content",
+                    "properties": {
+                      "byteLength": {
+                        "description": "Byte length of the current page",
+                        "maximum": 9007199254740991,
+                        "minimum": 0,
+                        "type": "integer"
+                      },
+                      "byteOffset": {
+                        "description": "Byte offset of the current page",
+                        "maximum": 9007199254740991,
+                        "minimum": 0,
+                        "type": "integer"
+                      },
+                      "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"
+                      },
+                      "totalBytes": {
+                        "description": "Total number of bytes in the full output",
+                        "maximum": 9007199254740991,
+                        "minimum": 0,
+                        "type": "integer"
+                      },
+                      "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"
+                    ],
+                    "type": "object"
+                  },
+                  "resolvedBranch": {
+                    "description": "Resolved branch used to fetch the content when it adds new information beyond the input query",
+                    "type": "string"
+                  },
+                  "startLine": {
+                    "description": "Starting line number of the returned content",
+                    "exclusiveMinimum": 0,
+                    "maximum": 9007199254740991,
+                    "type": "integer"
+                  },
+                  "totalSize": {
+                    "description": "Total fetched size in bytes",
+                    "maximum": 9007199254740991,
+                    "minimum": 0,
+                    "type": "integer"
+                  }
+                },
+                "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 file fetch queries for parallel execution"New value: +"Research queries for githubGetFileContent (1-3 queries per call for optimal resource management). Review schema before use for optimal results"

Removed value: -"Branch name, tag name, OR commit SHA. Tool will automatically try 'main' and 'master' if specified branch is not found."

Removed value: -"^[^\\s]+$"

Added value: +{
+  "maximum": 50000,
+  "minimum": 50,
+  "type": "integer"
+}

Added value: +{
+  "minimum": 0,
+  "type": "integer"
+}

Removed value: -{
-  "default": 5,
-  "description": "Context lines around target range. Default: 5.",
-  "maximum": 50,
-  "minimum": 0,
-  "type": "integer"
-}

Removed value: -"Ending line number (1-based) for partial file access. Use with startLine to fetch only specific sections and save tokens."

Removed value: -{
-  "additionalProperties": false,
-  "description": "Fallback parameters if original query returns no results",
-  "properties": {
-    "branch": {
-      "type": "string"
-    },
-    "contextLines": {
-      "maximum": 50,
-      "minimum": 0,
-      "type": "integer"
-    },
-    "endLine": {
-      "minimum": 1,
-      "type": "integer"
-    },
-    "filePath": {
-      "type": "string"
-    },
-    "minified": {
-      "type": "boolean"
-    },
-    "startLine": {
-      "minimum": 1,
-      "type": "integer"
-    }
-  },
-  "type": "object"
-}

Removed value: -{
-  "description": "File path from repository root (e.g., 'src/index.js', 'README.md', 'docs/api.md'). Do NOT start with slash.",
-  "minLength": 1,
-  "type": "string"
-}

Added value: +{
+  "default": false,
+  "type": "boolean"
+}

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

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

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

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

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: -"Repository owner/organization name (e.g., 'facebook', 'microsoft'). Do NOT include repository name here."

Previous value: -100New value: +200

Removed value: -"^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?$"

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

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

Removed value: -"Repository name only (e.g., 'react', 'vscode'). Do NOT include owner/org prefix."

Previous value: -100New value: +150

Removed value: -"^[a-zA-Z0-9._-]+$"

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

Removed value: -"Starting line number (1-based) for partial file access. STRONGLY RECOMMENDED to save tokens instead of fetching full file content."

Previous value: -[
-  "owner",
-  "repo",
-  "branch",
-  "filePath"
-]New value: +[
+  "mainResearchGoal",
+  "researchGoal",
+  "reasoning",
+  "owner",
+  "repo",
+  "path"
+]

Previous value: -5New value: +3