octocode-mcp 9.0.0 → 9.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "octocode-mcp",
-  "version": "9.0.0",
+  "version": "9.2.0",
   "description": "Model Context Protocol (MCP) server for advanced GitHub repository analysis and code discovery. Provides AI assistants with powerful tools to search, analyze, and understand codebases across GitHub.",
   "keywords": [
     "mcp",
@@ -41,21 +41,35 @@
     "@octokit/plugin-rest-endpoint-methods": "^17.0.0",
     "@octokit/plugin-throttling": "^11.0.3",
     "axios": "^1.13.2",
+    "clean-css": "^5.3.0",
     "dotenv": "^17.2.3",
     "express": "^5.1.0",
+    "html-minifier-terser": "^7.2.0",
+    "js-yaml": "^4.1.0",
     "node-cache": "^5.1.2",
-    "octocode-utils": "^6.0.0",
     "octokit": "^5.0.5",
+    "terser": "^5.19.0",
     "uuid": "^13.0.0",
-    "zod": "^3.23.8"
+    "zod": "^3.24.0"
   },
   "devDependencies": {
+    "@microsoft/tiktokenizer": "^1.0.10",
+    "@types/clean-css": "^4.2.11",
     "@types/express": "^5",
+    "@types/html-minifier-terser": "^7.0.2",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.15.29",
+    "@typescript-eslint/eslint-plugin": "^8.32.0",
+    "@typescript-eslint/parser": "^8.32.0",
+    "@vitest/coverage-v8": "^4.0.13",
+    "@vitest/ui": "^4.0.13",
     "eslint": "^8.57.0",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-prettier": "^5.5.4",
     "prettier": "^3.5.3",
-    "rollup": "^4.46.2",
-    "rollup-plugin-string": "^3.0.0",
-    "typescript": "^5.9.2",
+    "tslib": "^2.8.1",
+    "tsup": "^8.4.0",
+    "typescript": "^5.9.3",
     "vitest": "^4.0.13"
   },
   "engines": {
@@ -63,13 +77,11 @@
   },
   "exports": {
     ".": {
-      "types": "./dist/src/index.d.ts",
       "import": "./dist/index.js"
     }
   },
   "files": [
     "dist/index.js",
-    "dist/**/*.d.ts",
     "manifest.json",
     "server.json",
     "LICENSE"
@@ -82,9 +94,17 @@
   },
   "mcpName": "io.github.bgauryy/octocode-mcp",
   "scripts": {
-    "build": "yarn lint && yarn clean && tsc -p tsconfig.build.json && rollup -c",
-    "build:dev": "yarn clean && rollup -c",
-    "build:watch": "rollup -c --watch",
+    "build": "yarn lint && yarn clean && tsup",
+    "build:bin": "bun build ./src/index.ts --compile --minify --sourcemap --outfile dist/octocode-mcp",
+    "build:bin:all": "bun run build:bin:linux-x64 && bun run build:bin:linux-arm64 && bun run build:bin:linux-x64-musl && bun run build:bin:darwin-arm64 && bun run build:bin:darwin-x64 && bun run build:bin:windows-x64",
+    "build:bin:darwin-arm64": "bun build ./src/index.ts --compile --minify --sourcemap --target=bun-darwin-arm64 --outfile dist/octocode-mcp-darwin-arm64",
+    "build:bin:darwin-x64": "bun build ./src/index.ts --compile --minify --sourcemap --target=bun-darwin-x64 --outfile dist/octocode-mcp-darwin-x64",
+    "build:bin:linux-arm64": "bun build ./src/index.ts --compile --minify --sourcemap --target=bun-linux-arm64 --outfile dist/octocode-mcp-linux-arm64",
+    "build:bin:linux-x64": "bun build ./src/index.ts --compile --minify --sourcemap --target=bun-linux-x64 --outfile dist/octocode-mcp-linux-x64",
+    "build:bin:linux-x64-musl": "bun build ./src/index.ts --compile --minify --sourcemap --target=bun-linux-x64-musl --outfile dist/octocode-mcp-linux-x64-musl",
+    "build:bin:windows-x64": "bun build ./src/index.ts --compile --minify --sourcemap --target=bun-windows-x64 --outfile dist/octocode-mcp-windows-x64.exe",
+    "build:dev": "yarn clean && tsup",
+    "build:watch": "tsup --watch",
     "clean": "rm -rf dist/",
     "debug": "npx @modelcontextprotocol/inspector node dist/index.js",
     "dxt:pack": "yarn build && dxt pack . octocode-mcp.dxt",
@@ -95,13 +115,12 @@
     "lint": "eslint src/**/*.ts tests/**/*.ts",
     "lint:fix": "eslint src/**/*.ts tests/**/*.ts --fix",
     "prepack": "yarn build",
-    "prepublishOnly": "yarn lint && yarn test && rollup -c",
+    "prepublishOnly": "yarn lint && yarn test && tsup",
     "test": "vitest run --coverage",
     "test:coverage": "vitest run --coverage",
     "test:quiet": "vitest run --reporter=dot --silent",
     "test:ui": "vitest --ui",
     "test:watch": "vitest --watch"
   },
-  "type": "module",
-  "types": "dist/src/index.d.ts"
-}
+  "type": "module"
+}

package/dist/src/errorCodes.d.ts

@@ -1,353 +0,0 @@
-export declare const CONFIG_ERRORS: {
-    readonly NOT_INITIALIZED: {
-        readonly code: "CONFIG_NOT_INITIALIZED";
-        readonly message: "Configuration not initialized. Call initialize() and await its completion before calling getServerConfig().";
-    };
-    readonly NO_GITHUB_TOKEN: {
-        readonly code: "CONFIG_NO_GITHUB_TOKEN";
-        readonly message: "No GitHub token found. Please authenticate with GitHub CLI (gh auth login) or set GITHUB_TOKEN/GH_TOKEN environment variable";
-    };
-};
-export declare const VALIDATION_ERRORS: {
-    readonly PROMISES_NOT_ARRAY: {
-        readonly code: "VALIDATION_PROMISES_NOT_ARRAY";
-        readonly message: "promises must be an array";
-    };
-    readonly TIMEOUT_NOT_POSITIVE: {
-        readonly code: "VALIDATION_TIMEOUT_NOT_POSITIVE";
-        readonly message: "timeout must be positive";
-    };
-    readonly CONCURRENCY_NOT_POSITIVE: {
-        readonly code: "VALIDATION_CONCURRENCY_NOT_POSITIVE";
-        readonly message: "concurrency must be positive";
-    };
-    readonly INVALID_PARAMETERS: {
-        readonly code: "VALIDATION_INVALID_PARAMETERS";
-        readonly message: "Invalid parameters: must be an object";
-    };
-    readonly INVALID_PARAMETER_KEY: {
-        readonly code: "VALIDATION_INVALID_PARAMETER_KEY";
-        readonly message: (key: string) => string;
-    };
-    readonly INVALID_NESTED_OBJECT: {
-        readonly code: "VALIDATION_INVALID_NESTED_OBJECT";
-        readonly message: (key: string, warnings: string) => string;
-    };
-};
-export declare const FETCH_ERRORS: {
-    readonly FETCH_NOT_AVAILABLE: {
-        readonly code: "FETCH_NOT_AVAILABLE";
-        readonly message: "Global fetch is not available in this environment.";
-    };
-    readonly FETCH_FAILED_AFTER_RETRIES: {
-        readonly code: "FETCH_FAILED_AFTER_RETRIES";
-        readonly message: (attempts: number, errorMessage: string) => string;
-    };
-    readonly FETCH_HTTP_ERROR: {
-        readonly code: "FETCH_HTTP_ERROR";
-        readonly message: (status: number, statusText: string) => string;
-    };
-};
-export declare const TOOL_METADATA_ERRORS: {
-    readonly INVALID_FORMAT: {
-        readonly code: "TOOL_METADATA_INVALID_FORMAT";
-        readonly message: "Invalid tool metadata format from remote source.";
-    };
-    readonly INVALID_API_RESPONSE: {
-        readonly code: "TOOL_METADATA_INVALID_API_RESPONSE";
-        readonly message: "Invalid API response structure";
-    };
-};
-export declare const FILE_OPERATION_ERRORS: {
-    readonly PATH_IS_DIRECTORY: {
-        readonly code: "FILE_PATH_IS_DIRECTORY";
-        readonly message: (toolName: string) => string;
-    };
-    readonly FILE_TOO_LARGE: {
-        readonly code: "FILE_TOO_LARGE";
-        readonly message: (fileSizeKB: number, maxSizeKB: number, toolName: string) => string;
-    };
-    readonly FILE_EMPTY: {
-        readonly code: "FILE_EMPTY";
-        readonly message: "File is empty - no content to display";
-    };
-    readonly BINARY_FILE: {
-        readonly code: "FILE_BINARY";
-        readonly message: "Binary file detected. Cannot display as text - download directly from GitHub";
-    };
-    readonly DECODE_FAILED: {
-        readonly code: "FILE_DECODE_FAILED";
-        readonly message: "Failed to decode file. Encoding may not be supported (expected UTF-8)";
-    };
-    readonly UNSUPPORTED_TYPE: {
-        readonly code: "FILE_UNSUPPORTED_TYPE";
-        readonly message: (type: string) => string;
-    };
-    readonly MATCH_STRING_NOT_FOUND: {
-        readonly code: "FILE_MATCH_STRING_NOT_FOUND";
-        readonly message: (matchString: string) => string;
-    };
-};
-export declare const REPOSITORY_ERRORS: {
-    readonly NOT_FOUND: {
-        readonly code: "REPO_NOT_FOUND";
-        readonly message: (owner: string, repo: string, error: string) => string;
-    };
-    readonly PATH_NOT_FOUND: {
-        readonly code: "REPO_PATH_NOT_FOUND";
-        readonly message: (path: string, owner: string, repo: string, branch: string) => string;
-    };
-    readonly PATH_NOT_FOUND_ANY_BRANCH: {
-        readonly code: "REPO_PATH_NOT_FOUND_ANY_BRANCH";
-        readonly message: (path: string, owner: string, repo: string) => string;
-    };
-    readonly ACCESS_FAILED: {
-        readonly code: "REPO_ACCESS_FAILED";
-        readonly message: (owner: string, repo: string, error: string) => string;
-    };
-    readonly BRANCH_NOT_FOUND: {
-        readonly code: "REPO_BRANCH_NOT_FOUND";
-        readonly message: (branch: string) => string;
-    };
-    readonly STRUCTURE_EXPLORATION_FAILED: {
-        readonly code: "REPO_STRUCTURE_EXPLORATION_FAILED";
-        readonly message: "Failed to explore repository structure";
-    };
-};
-export declare const SEARCH_ERRORS: {
-    readonly QUERY_EMPTY: {
-        readonly code: "SEARCH_QUERY_EMPTY";
-        readonly message: "Search query cannot be empty";
-    };
-    readonly NO_VALID_PARAMETERS: {
-        readonly code: "SEARCH_NO_VALID_PARAMETERS";
-        readonly message: "No valid search parameters provided";
-    };
-    readonly PR_REQUIRED_PARAMS: {
-        readonly code: "SEARCH_PR_REQUIRED_PARAMS";
-        readonly message: "Owner, repo, and prNumber are required parameters";
-    };
-    readonly PR_SINGLE_VALUES: {
-        readonly code: "SEARCH_PR_SINGLE_VALUES";
-        readonly message: "Owner and repo must be single values";
-    };
-    readonly API_REQUEST_FAILED: {
-        readonly code: "SEARCH_API_REQUEST_FAILED";
-        readonly message: (error: string) => string;
-    };
-    readonly PULL_REQUEST_SEARCH_FAILED: {
-        readonly code: "SEARCH_PR_SEARCH_FAILED";
-        readonly message: (error: string) => string;
-    };
-    readonly PULL_REQUEST_LIST_FAILED: {
-        readonly code: "SEARCH_PR_LIST_FAILED";
-        readonly message: (error: string) => string;
-    };
-    readonly PULL_REQUEST_FETCH_FAILED: {
-        readonly code: "SEARCH_PR_FETCH_FAILED";
-        readonly message: (prNumber: number, error: string) => string;
-    };
-};
-export declare const STARTUP_ERRORS: {
-    readonly NO_TOOLS_REGISTERED: {
-        readonly code: "STARTUP_NO_TOOLS_REGISTERED";
-        readonly message: "No tools were successfully registered";
-    };
-    readonly UNCAUGHT_EXCEPTION: {
-        readonly code: "STARTUP_UNCAUGHT_EXCEPTION";
-        readonly message: (error: string) => string;
-    };
-    readonly UNHANDLED_REJECTION: {
-        readonly code: "STARTUP_UNHANDLED_REJECTION";
-        readonly message: (reason: string) => string;
-    };
-    readonly STARTUP_FAILED: {
-        readonly code: "STARTUP_FAILED";
-        readonly message: (error: string) => string;
-    };
-};
-export declare const PROMISE_ERRORS: {
-    readonly TIMEOUT: {
-        readonly code: "PROMISE_TIMEOUT";
-        readonly message: (index: number, timeout: number) => string;
-    };
-    readonly NOT_A_FUNCTION: {
-        readonly code: "PROMISE_NOT_A_FUNCTION";
-        readonly message: (index: number) => string;
-    };
-    readonly FUNCTION_UNDEFINED: {
-        readonly code: "PROMISE_FUNCTION_UNDEFINED";
-        readonly message: "Promise function is undefined";
-    };
-};
-export declare const ALL_ERROR_CODES: {
-    readonly TIMEOUT: {
-        readonly code: "PROMISE_TIMEOUT";
-        readonly message: (index: number, timeout: number) => string;
-    };
-    readonly NOT_A_FUNCTION: {
-        readonly code: "PROMISE_NOT_A_FUNCTION";
-        readonly message: (index: number) => string;
-    };
-    readonly FUNCTION_UNDEFINED: {
-        readonly code: "PROMISE_FUNCTION_UNDEFINED";
-        readonly message: "Promise function is undefined";
-    };
-    readonly NO_TOOLS_REGISTERED: {
-        readonly code: "STARTUP_NO_TOOLS_REGISTERED";
-        readonly message: "No tools were successfully registered";
-    };
-    readonly UNCAUGHT_EXCEPTION: {
-        readonly code: "STARTUP_UNCAUGHT_EXCEPTION";
-        readonly message: (error: string) => string;
-    };
-    readonly UNHANDLED_REJECTION: {
-        readonly code: "STARTUP_UNHANDLED_REJECTION";
-        readonly message: (reason: string) => string;
-    };
-    readonly STARTUP_FAILED: {
-        readonly code: "STARTUP_FAILED";
-        readonly message: (error: string) => string;
-    };
-    readonly QUERY_EMPTY: {
-        readonly code: "SEARCH_QUERY_EMPTY";
-        readonly message: "Search query cannot be empty";
-    };
-    readonly NO_VALID_PARAMETERS: {
-        readonly code: "SEARCH_NO_VALID_PARAMETERS";
-        readonly message: "No valid search parameters provided";
-    };
-    readonly PR_REQUIRED_PARAMS: {
-        readonly code: "SEARCH_PR_REQUIRED_PARAMS";
-        readonly message: "Owner, repo, and prNumber are required parameters";
-    };
-    readonly PR_SINGLE_VALUES: {
-        readonly code: "SEARCH_PR_SINGLE_VALUES";
-        readonly message: "Owner and repo must be single values";
-    };
-    readonly API_REQUEST_FAILED: {
-        readonly code: "SEARCH_API_REQUEST_FAILED";
-        readonly message: (error: string) => string;
-    };
-    readonly PULL_REQUEST_SEARCH_FAILED: {
-        readonly code: "SEARCH_PR_SEARCH_FAILED";
-        readonly message: (error: string) => string;
-    };
-    readonly PULL_REQUEST_LIST_FAILED: {
-        readonly code: "SEARCH_PR_LIST_FAILED";
-        readonly message: (error: string) => string;
-    };
-    readonly PULL_REQUEST_FETCH_FAILED: {
-        readonly code: "SEARCH_PR_FETCH_FAILED";
-        readonly message: (prNumber: number, error: string) => string;
-    };
-    readonly NOT_FOUND: {
-        readonly code: "REPO_NOT_FOUND";
-        readonly message: (owner: string, repo: string, error: string) => string;
-    };
-    readonly PATH_NOT_FOUND: {
-        readonly code: "REPO_PATH_NOT_FOUND";
-        readonly message: (path: string, owner: string, repo: string, branch: string) => string;
-    };
-    readonly PATH_NOT_FOUND_ANY_BRANCH: {
-        readonly code: "REPO_PATH_NOT_FOUND_ANY_BRANCH";
-        readonly message: (path: string, owner: string, repo: string) => string;
-    };
-    readonly ACCESS_FAILED: {
-        readonly code: "REPO_ACCESS_FAILED";
-        readonly message: (owner: string, repo: string, error: string) => string;
-    };
-    readonly BRANCH_NOT_FOUND: {
-        readonly code: "REPO_BRANCH_NOT_FOUND";
-        readonly message: (branch: string) => string;
-    };
-    readonly STRUCTURE_EXPLORATION_FAILED: {
-        readonly code: "REPO_STRUCTURE_EXPLORATION_FAILED";
-        readonly message: "Failed to explore repository structure";
-    };
-    readonly PATH_IS_DIRECTORY: {
-        readonly code: "FILE_PATH_IS_DIRECTORY";
-        readonly message: (toolName: string) => string;
-    };
-    readonly FILE_TOO_LARGE: {
-        readonly code: "FILE_TOO_LARGE";
-        readonly message: (fileSizeKB: number, maxSizeKB: number, toolName: string) => string;
-    };
-    readonly FILE_EMPTY: {
-        readonly code: "FILE_EMPTY";
-        readonly message: "File is empty - no content to display";
-    };
-    readonly BINARY_FILE: {
-        readonly code: "FILE_BINARY";
-        readonly message: "Binary file detected. Cannot display as text - download directly from GitHub";
-    };
-    readonly DECODE_FAILED: {
-        readonly code: "FILE_DECODE_FAILED";
-        readonly message: "Failed to decode file. Encoding may not be supported (expected UTF-8)";
-    };
-    readonly UNSUPPORTED_TYPE: {
-        readonly code: "FILE_UNSUPPORTED_TYPE";
-        readonly message: (type: string) => string;
-    };
-    readonly MATCH_STRING_NOT_FOUND: {
-        readonly code: "FILE_MATCH_STRING_NOT_FOUND";
-        readonly message: (matchString: string) => string;
-    };
-    readonly INVALID_FORMAT: {
-        readonly code: "TOOL_METADATA_INVALID_FORMAT";
-        readonly message: "Invalid tool metadata format from remote source.";
-    };
-    readonly INVALID_API_RESPONSE: {
-        readonly code: "TOOL_METADATA_INVALID_API_RESPONSE";
-        readonly message: "Invalid API response structure";
-    };
-    readonly FETCH_NOT_AVAILABLE: {
-        readonly code: "FETCH_NOT_AVAILABLE";
-        readonly message: "Global fetch is not available in this environment.";
-    };
-    readonly FETCH_FAILED_AFTER_RETRIES: {
-        readonly code: "FETCH_FAILED_AFTER_RETRIES";
-        readonly message: (attempts: number, errorMessage: string) => string;
-    };
-    readonly FETCH_HTTP_ERROR: {
-        readonly code: "FETCH_HTTP_ERROR";
-        readonly message: (status: number, statusText: string) => string;
-    };
-    readonly PROMISES_NOT_ARRAY: {
-        readonly code: "VALIDATION_PROMISES_NOT_ARRAY";
-        readonly message: "promises must be an array";
-    };
-    readonly TIMEOUT_NOT_POSITIVE: {
-        readonly code: "VALIDATION_TIMEOUT_NOT_POSITIVE";
-        readonly message: "timeout must be positive";
-    };
-    readonly CONCURRENCY_NOT_POSITIVE: {
-        readonly code: "VALIDATION_CONCURRENCY_NOT_POSITIVE";
-        readonly message: "concurrency must be positive";
-    };
-    readonly INVALID_PARAMETERS: {
-        readonly code: "VALIDATION_INVALID_PARAMETERS";
-        readonly message: "Invalid parameters: must be an object";
-    };
-    readonly INVALID_PARAMETER_KEY: {
-        readonly code: "VALIDATION_INVALID_PARAMETER_KEY";
-        readonly message: (key: string) => string;
-    };
-    readonly INVALID_NESTED_OBJECT: {
-        readonly code: "VALIDATION_INVALID_NESTED_OBJECT";
-        readonly message: (key: string, warnings: string) => string;
-    };
-    readonly NOT_INITIALIZED: {
-        readonly code: "CONFIG_NOT_INITIALIZED";
-        readonly message: "Configuration not initialized. Call initialize() and await its completion before calling getServerConfig().";
-    };
-    readonly NO_GITHUB_TOKEN: {
-        readonly code: "CONFIG_NO_GITHUB_TOKEN";
-        readonly message: "No GitHub token found. Please authenticate with GitHub CLI (gh auth login) or set GITHUB_TOKEN/GH_TOKEN environment variable";
-    };
-};
-export type ErrorCategory = 'CONFIG' | 'VALIDATION' | 'FETCH' | 'TOOL_METADATA' | 'FILE_OPERATION' | 'REPOSITORY' | 'SEARCH' | 'STARTUP' | 'PROMISE';
-export type ErrorCode = (typeof ALL_ERROR_CODES)[keyof typeof ALL_ERROR_CODES]['code'];
-export declare function getErrorsByCategory(category: ErrorCategory): Record<string, unknown>;
-export declare function getAllErrorCodes(): string[];
-export declare function isValidErrorCode(code: string): boolean;

package/dist/src/github/client.d.ts

@@ -1,4 +0,0 @@
-import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
-export declare const OctokitWithThrottling: any;
-export declare function getOctokit(authInfo?: AuthInfo): Promise<InstanceType<typeof OctokitWithThrottling>>;
-export declare function clearCachedToken(): void;

package/dist/src/github/codeSearch.d.ts

@@ -1,4 +0,0 @@
-import type { GitHubAPIResponse, OptimizedCodeSearchResult } from './githubAPI';
-import { GitHubCodeSearchQuery } from '../types';
-import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
-export declare function searchGitHubCodeAPI(params: GitHubCodeSearchQuery, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubAPIResponse<OptimizedCodeSearchResult>>;

package/dist/src/github/errorConstants.d.ts

@@ -1,173 +0,0 @@
-/**
- * GitHub API Error Constants
- * Centralized error definitions with keys, messages, and explanations
- */
-/**
- * Error codes for internal tracking and testing
- */
-export declare const ERROR_CODES: {
-    readonly AUTH_REQUIRED: "AUTH_REQUIRED";
-    readonly RATE_LIMIT_PRIMARY: "RATE_LIMIT_PRIMARY";
-    readonly RATE_LIMIT_SECONDARY: "RATE_LIMIT_SECONDARY";
-    readonly FORBIDDEN_PERMISSIONS: "FORBIDDEN_PERMISSIONS";
-    readonly NOT_FOUND: "NOT_FOUND";
-    readonly INVALID_REQUEST: "INVALID_REQUEST";
-    readonly SERVER_UNAVAILABLE: "SERVER_UNAVAILABLE";
-    readonly NETWORK_CONNECTION_FAILED: "NETWORK_CONNECTION_FAILED";
-    readonly REQUEST_TIMEOUT: "REQUEST_TIMEOUT";
-    readonly UNKNOWN: "UNKNOWN";
-};
-export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
-/**
- * Error message templates with explanations
- */
-export declare const ERROR_MESSAGES: {
-    /**
-     * 401 - Authentication Required
-     * When: No token provided or token is invalid
-     * Cause: Missing/invalid GITHUB_TOKEN or GH_TOKEN
-     * Fix: Set valid GitHub personal access token
-     */
-    readonly AUTH_REQUIRED: {
-        readonly message: "GitHub authentication required";
-        readonly suggestion: "TELL THE USER: Refresh your GitHub token! Run 'gh auth login' OR 'gh auth refresh' OR set a new GITHUB_TOKEN/GH_TOKEN environment variable";
-        readonly explanation: "API request requires authentication. GitHub APIs have different rate limits for authenticated (5000/hour) vs unauthenticated (60/hour) requests.";
-    };
-    /**
-     * 403 - Primary Rate Limit Exceeded
-     * When: Used all API quota for current hour (REST or GraphQL)
-     * Cause: Too many requests within rate limit window
-     * Fix: Wait until rate limit resets, or use authenticated requests for higher limits
-     * Docs: https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting
-     */
-    readonly RATE_LIMIT_PRIMARY: {
-        readonly message: "GitHub API rate limit exceeded";
-        readonly messageWithTime: (resetTime: Date, seconds: number) => string;
-        readonly messageWithoutTime: "GitHub API rate limit exceeded. Reset time unavailable - check GitHub status or try again later";
-        readonly suggestion: "Set GITHUB_TOKEN for higher rate limits (5000/hour vs 60/hour)";
-        readonly explanation: "Primary rate limit tracks total API calls per hour. Authenticated users get 5000 requests/hour, unauthenticated get 60 requests/hour.";
-    };
-    /**
-     * 403 - Secondary Rate Limit (Abuse Detection)
-     * When: Making requests too quickly (abuse detection)
-     * Cause: High frequency of requests triggering anti-abuse mechanisms
-     * Fix: Slow down request rate, add delays between requests
-     * Docs: https://docs.github.com/en/rest/overview/resources-in-the-rest-api#secondary-rate-limits
-     */
-    readonly RATE_LIMIT_SECONDARY: {
-        readonly message: (retryAfter: number) => string;
-        readonly suggestion: "Reduce request frequency to avoid abuse detection";
-        readonly explanation: "Secondary rate limits prevent API abuse by limiting request frequency. Triggered by making too many requests too quickly, regardless of remaining quota.";
-        readonly fallbackRetryAfter: 60;
-    };
-    /**
-     * 403 - Forbidden (Insufficient Permissions)
-     * When: Token lacks required scopes for the operation
-     * Cause: GitHub token missing necessary OAuth scopes
-     * Fix: Refresh token with required scopes using gh CLI
-     */
-    readonly FORBIDDEN_PERMISSIONS: {
-        readonly message: "Access forbidden - insufficient permissions";
-        readonly suggestion: "Check repository permissions or authentication";
-        readonly suggestionWithScopes: (missing: string[]) => string;
-        readonly fallbackSuggestion: "Token may not have sufficient permissions for this operation";
-        readonly explanation: "GitHub tokens require specific OAuth scopes for different operations. Common scopes: repo (full repository access), read:org (organization access), gist (gist access).";
-    };
-    /**
-     * 404 - Not Found
-     * When: Repository, file, or resource does not exist or is inaccessible
-     * Cause: Wrong path, deleted resource, or private repo without access
-     * Fix: Verify resource exists, check spelling, ensure token has access to private repos
-     */
-    readonly NOT_FOUND: {
-        readonly message: "Repository, resource, or path not found";
-        readonly explanation: "Resource not found or not accessible. Could be: incorrect path, deleted resource, private repository without access, wrong branch name.";
-    };
-    /**
-     * 422 - Unprocessable Entity (Validation Error)
-     * When: Request parameters are invalid or malformed
-     * Cause: Invalid search query syntax, invalid parameter values
-     * Fix: Check API documentation for correct parameter format
-     * Docs: https://docs.github.com/en/rest/overview/resources-in-the-rest-api#client-errors
-     */
-    readonly INVALID_REQUEST: {
-        readonly message: "Invalid search query or request parameters";
-        readonly suggestion: "Check search syntax and parameter values";
-        readonly explanation: "Request was well-formed but contains invalid parameters. Common causes: invalid search syntax, parameters out of range, invalid filter combinations.";
-    };
-    /**
-     * 502/503/504 - Server Errors
-     * When: GitHub API is temporarily unavailable
-     * Cause: GitHub server issues, maintenance, or overload
-     * Fix: Retry after a short delay, check GitHub status page
-     */
-    readonly SERVER_UNAVAILABLE: {
-        readonly message: "GitHub API temporarily unavailable";
-        readonly suggestion: "Retry the request after a short delay";
-        readonly explanation: "GitHub servers are temporarily unavailable. Usually resolves quickly. Check https://www.githubstatus.com for service status.";
-    };
-    /**
-     * Network Error - Connection Failed
-     * When: Cannot reach GitHub API servers
-     * Cause: No internet connection, DNS failure, firewall blocking
-     * Fix: Check internet connection, verify DNS resolution, check firewall settings
-     */
-    readonly NETWORK_CONNECTION_FAILED: {
-        readonly message: "Network connection failed";
-        readonly suggestion: "Check internet connection and GitHub API status";
-        readonly explanation: "Cannot establish connection to GitHub API. Check internet connectivity, DNS settings, and firewall/proxy configuration.";
-    };
-    /**
-     * Network Error - Request Timeout
-     * When: Request takes too long to complete
-     * Cause: Slow network, large response, GitHub server delay
-     * Fix: Retry request, check network speed, consider pagination for large requests
-     */
-    readonly REQUEST_TIMEOUT: {
-        readonly message: "Request timeout";
-        readonly suggestion: "Retry the request or check network connectivity";
-        readonly explanation: "Request exceeded timeout limit. Could be slow network, large response size, or GitHub server delay.";
-    };
-    /**
-     * Unknown Error
-     * When: Unrecognized error occurred
-     * Cause: Unexpected error not matching known patterns
-     * Fix: Check error message for details, report if persistent
-     */
-    readonly UNKNOWN: {
-        readonly message: "Unknown error occurred";
-        readonly explanation: "An unexpected error occurred that does not match known error patterns.";
-    };
-};
-/**
- * HTTP status code to error code mapping
- */
-export declare const STATUS_TO_ERROR_CODE: Record<number, ErrorCode>;
-/**
- * Network error patterns
- */
-export declare const NETWORK_ERROR_PATTERNS: {
-    readonly CONNECTION_FAILED: readonly ["ENOTFOUND", "ECONNREFUSED"];
-    readonly TIMEOUT: readonly ["timeout"];
-};
-/**
- * Rate limit detection patterns
- */
-export declare const RATE_LIMIT_PATTERNS: {
-    readonly SECONDARY: RegExp;
-    readonly GRAPHQL_TYPE: "RATE_LIMITED";
-};
-/**
- * Rate limit configuration
- */
-export declare const RATE_LIMIT_CONFIG: {
-    /**
-     * Add 1 second buffer to rate limit reset time per GitHub best practices
-     * Docs: https://docs.github.com/en/rest/overview/resources-in-the-rest-api#exceeding-the-rate-limit
-     */
-    readonly RESET_BUFFER_SECONDS: 1;
-    /**
-     * Default secondary rate limit retry delay when no retry-after header present
-     */
-    readonly SECONDARY_FALLBACK_SECONDS: 60;
-};

package/dist/src/github/errors.d.ts

@@ -1,4 +0,0 @@
-import type { GitHubAPIError } from './githubAPI';
-import { ERROR_CODES, ERROR_MESSAGES, type ErrorCode } from './errorConstants.js';
-export declare function handleGitHubAPIError(error: unknown): GitHubAPIError;
-export { ERROR_CODES, ERROR_MESSAGES, type ErrorCode };

package/dist/src/github/fileOperations.d.ts

@@ -1,6 +0,0 @@
-import type { GitHubAPIResponse } from './githubAPI';
-import type { FileContentQuery, ContentResult, GitHubViewRepoStructureQuery } from '../types';
-import type { GitHubRepositoryStructureResult, GitHubRepositoryStructureError } from '../scheme/github_view_repo_structure';
-import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
-export declare function fetchGitHubFileContentAPI(params: FileContentQuery, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubAPIResponse<ContentResult>>;
-export declare function viewGitHubRepositoryStructureAPI(params: GitHubViewRepoStructureQuery, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubRepositoryStructureResult | GitHubRepositoryStructureError>;