octocode-mcp 7.0.12 → 7.0.13

package/dist/src/tools/toolMetadata.d.ts

@@ -0,0 +1,218 @@
+export interface ToolMetadata {
+    name: string;
+    description: string;
+    schema: Record<string, string>;
+    hints: {
+        hasResults: readonly string[];
+        empty: readonly string[];
+    };
+}
+export interface CompleteMetadata {
+    instructions: string;
+    prompts: {
+        research: {
+            name: string;
+            description: string;
+            content: string;
+        };
+        reviewSecurity: {
+            name: string;
+            description: string;
+            content: string;
+        };
+        use: {
+            name: string;
+            description: string;
+            content: string;
+        };
+        [key: string]: {
+            name: string;
+            description: string;
+            content: string;
+        };
+    };
+    toolNames: {
+        GITHUB_FETCH_CONTENT: 'githubGetFileContent';
+        GITHUB_SEARCH_CODE: 'githubSearchCode';
+        GITHUB_SEARCH_PULL_REQUESTS: 'githubSearchPullRequests';
+        GITHUB_SEARCH_REPOSITORIES: 'githubSearchRepositories';
+        GITHUB_VIEW_REPO_STRUCTURE: 'githubViewRepoStructure';
+    };
+    baseSchema: {
+        mainResearchGoal: string;
+        researchGoal: string;
+        reasoning: string;
+        bulkQuery: (toolName: string) => string;
+    };
+    tools: Record<string, ToolMetadata>;
+    baseHints: {
+        hasResults: readonly string[];
+        empty: readonly string[];
+    };
+    genericErrorHints: readonly string[];
+}
+export declare function initializeToolMetadata(): Promise<void>;
+export declare function loadToolContent(): Promise<CompleteMetadata>;
+export declare function getInstructionsSync(): string;
+export declare function getPromptsSync(): CompleteMetadata['prompts'];
+export declare const TOOL_NAMES: CompleteMetadata["toolNames"];
+export type ToolName = (typeof TOOL_NAMES)[keyof typeof TOOL_NAMES];
+export declare const BASE_SCHEMA: CompleteMetadata["baseSchema"];
+export declare const GENERIC_ERROR_HINTS: readonly string[];
+export declare function getCompleteMetadata(): Promise<CompleteMetadata>;
+export declare function getToolsMetadata(): Promise<Record<string, ToolMetadata>>;
+export declare function getToolMetadata(toolName: string): Promise<ToolMetadata | undefined>;
+export declare function getToolDescription(toolName: string): Promise<string>;
+export declare function getToolSchema(toolName: string): Promise<Record<string, string>>;
+export declare function isToolAvailableSync(toolName: string): boolean;
+export declare function getToolHints(toolName: string, resultType: 'hasResults' | 'empty'): Promise<readonly string[]>;
+export declare function getToolHintsSync(toolName: string, resultType: 'hasResults' | 'empty'): readonly string[];
+export declare function getGenericErrorHints(): Promise<readonly string[]>;
+export declare function getGenericErrorHintsSync(): readonly string[];
+export declare function getBaseHints(): Promise<{
+    hasResults: readonly string[];
+    empty: readonly string[];
+}>;
+export declare function getDynamicHints(toolName: string, hintType: 'topicsHasResults' | 'topicsEmpty' | 'keywordsEmpty'): readonly string[];
+export declare function getBulkOperationsInstructions(): {
+    base: string;
+    hasResults: string;
+    empty: string;
+    error: string;
+};
+export declare const DESCRIPTIONS: Record<string, string>;
+export declare const TOOL_HINTS: Record<string, {
+    hasResults: readonly string[];
+    empty: readonly string[];
+}> & {
+    base: {
+        hasResults: readonly string[];
+        empty: readonly string[];
+    };
+};
+export declare const GITHUB_FETCH_CONTENT: {
+    scope: {
+        owner: string;
+        repo: string;
+        branch: string;
+        path: string;
+    };
+    processing: {
+        minified: string;
+        sanitize: string;
+    };
+    range: {
+        startLine: string;
+        endLine: string;
+        fullContent: string;
+        matchString: string;
+        matchStringContextLines: string;
+    };
+    validation: {
+        parameterConflict: string;
+    };
+};
+export declare const GITHUB_SEARCH_CODE: {
+    search: {
+        keywordsToSearch: string;
+    };
+    scope: {
+        owner: string;
+        repo: string;
+    };
+    filters: {
+        extension: string;
+        stars: string;
+        filename: string;
+        path: string;
+        match: string;
+    };
+    resultLimit: {
+        limit: string;
+    };
+    processing: {
+        minify: string;
+        sanitize: string;
+    };
+};
+export declare const GITHUB_SEARCH_REPOS: {
+    search: {
+        keywordsToSearch: string;
+        topicsToSearch: string;
+    };
+    scope: {
+        owner: string;
+    };
+    filters: {
+        stars: string;
+        size: string;
+        created: string;
+        updated: string;
+        match: string;
+    };
+    sorting: {
+        sort: string;
+    };
+    resultLimit: {
+        limit: string;
+    };
+};
+export declare const GITHUB_SEARCH_PULL_REQUESTS: {
+    search: {
+        query: string;
+    };
+    scope: {
+        prNumber: string;
+        owner: string;
+        repo: string;
+    };
+    filters: {
+        match: string;
+        created: string;
+        updated: string;
+        state: string;
+        assignee: string;
+        author: string;
+        commenter: string;
+        involves: string;
+        mentions: string;
+        "review-requested": string;
+        "reviewed-by": string;
+        label: string;
+        "no-label": string;
+        "no-milestone": string;
+        "no-project": string;
+        "no-assignee": string;
+        head: string;
+        base: string;
+        closed: string;
+        "merged-at": string;
+        comments: string;
+        reactions: string;
+        interactions: string;
+        merged: string;
+        draft: string;
+    };
+    sorting: {
+        sort: string;
+        order: string;
+    };
+    resultLimit: {
+        limit: string;
+    };
+    outputShaping: {
+        withComments: string;
+        withContent: string;
+    };
+};
+export declare const GITHUB_VIEW_REPO_STRUCTURE: {
+    scope: {
+        owner: string;
+        repo: string;
+        branch: string;
+        path: string;
+    };
+    range: {
+        depth: string;
+    };
+};

package/dist/src/tools/utils.d.ts

@@ -1,6 +1,6 @@
 import type { GitHubAPIError } from '../github/githubAPI';
 import type { ToolErrorResult, ToolSuccessResult } from '../types.js';
-import { TOOL_NAMES } from '../constants.js';
+import { TOOL_NAMES } from './toolMetadata.js';
 export declare function createErrorResult(query: {
     mainResearchGoal?: string;
     researchGoal?: string;

package/dist/src/types.d.ts

@@ -358,13 +358,6 @@ export interface CacheStats {
     totalKeys: number;
     lastReset: Date;
 }
-/** Options for command execution */
-export type ExecOptions = {
-    timeout?: number;
-    cwd?: string;
-    env?: Record<string, string>;
-    cache?: boolean;
-};
 /** Result of a promise with error isolation */
 export interface PromiseResult<T> {
     success: boolean;

package/dist/src/utils/exec.d.ts

@@ -1,8 +1,3 @@
 import { CallToolResult } from '@modelcontextprotocol/sdk/types';
-import type { ExecOptions } from '../types.js';
-declare const ALLOWED_NPM_COMMANDS: readonly ["view", "search", "ping", "config", "whoami"];
-export type NpmCommand = (typeof ALLOWED_NPM_COMMANDS)[number];
 export declare function parseExecResult(stdout: string, stderr: string, error?: Error | null, exitCode?: number): CallToolResult;
-export declare function executeNpmCommand(command: NpmCommand, args: string[], options?: ExecOptions): Promise<CallToolResult>;
 export declare function getGithubCLIToken(): Promise<string | null>;
-export {};

package/dist/src/utils/fetchWithRetries.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Fetch with retry mechanism and exponential backoff
+ */
+export interface FetchWithRetriesOptions {
+    /**
+     * Maximum number of retry attempts (excluding the initial request)
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Initial delay in milliseconds for exponential backoff
+     * @default 1000 (1 second)
+     */
+    initialDelayMs?: number;
+    /**
+     * Custom headers to include in the request
+     */
+    headers?: Record<string, string>;
+    /**
+     * HTTP method
+     * @default 'GET'
+     */
+    method?: string;
+}
+/**
+ * Fetches a URL with automatic retries and exponential backoff.
+ *
+ * Retry behavior:
+ * - Retries on network errors, server errors (5xx), and rate limits (429)
+ * - Respects 'Retry-After' header for 429 responses
+ * - Does NOT retry on client errors (4xx) except rate limits
+ * - Uses exponential backoff: 1s, 2s, 4s (default) if no Retry-After header
+ *
+ * @param url - The URL to fetch
+ * @param options - Configuration options for retries and request
+ * @returns The JSON response (or null for 204 No Content)
+ * @throws Error if all retry attempts fail
+ *
+ * @example
+ * ```typescript
+ * const data = await fetchWithRetries('https://api.example.com/data', {
+ *   maxRetries: 3,
+ *   headers: { 'User-Agent': 'MyApp/1.0' }
+ * });
+ * ```
+ */
+export declare function fetchWithRetries(url: string, options?: FetchWithRetriesOptions): Promise<unknown>;

package/dist/tests/errorCodes.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/prompts/prompts.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/prompts/research.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/prompts/review_security.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/prompts/use.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/tools/toolsManager.metadata.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/utils/fetchWithRetries.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/utils/fileFilters.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "octocode-mcp",
-  "version": "7.0.12",
+  "version": "7.0.13",
   "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",
@@ -34,6 +34,12 @@
   "bugs": "https://github.com/bgauryy/octocode-mcp/issues",
   "license": "MIT",
   "mcpName": "io.github.bgauryy/octocode-mcp",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
   "bin": {
     "octocode-mcp": "dist/index.js",
     "octocode-mcp-beta": "dist/index.js"

package/server.json

@@ -8,12 +8,12 @@
     "url": "https://github.com/bgauryy/octocode-mcp",
     "source": "github"
   },
-  "version": "7.0.12",
+  "version": "7.0.13",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "octocode-mcp",
-      "version": "7.0.12",
+      "version": "7.0.13",
       "transport": {
         "type": "stdio"
       },

package/dist/src/constants.d.ts

@@ -1,8 +0,0 @@
-export declare const TOOL_NAMES: {
-    readonly GITHUB_FETCH_CONTENT: "githubGetFileContent";
-    readonly GITHUB_SEARCH_CODE: "githubSearchCode";
-    readonly GITHUB_SEARCH_PULL_REQUESTS: "githubSearchPullRequests";
-    readonly GITHUB_SEARCH_REPOSITORIES: "githubSearchRepositories";
-    readonly GITHUB_VIEW_REPO_STRUCTURE: "githubViewRepoStructure";
-};
-export type ToolName = (typeof TOOL_NAMES)[keyof typeof TOOL_NAMES];

package/dist/src/prompts/kudos.d.ts

@@ -1,3 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare const PROMPT_NAME = "kudos";
-export declare function registerKudosPrompt(server: McpServer): void;

package/dist/src/scheme/schemDescriptions.d.ts

@@ -1,180 +0,0 @@
-export declare const COMMON: {
-    scope: {
-        owner: string;
-        repo: string;
-        branch: string;
-        path: string;
-    };
-    processing: {
-        minify: string;
-        minified: string;
-        sanitize: string;
-    };
-    filters: {
-        stars: string;
-        created: string;
-        updated: string;
-        state: string;
-        extension: string;
-        filename: string;
-    };
-    users: {
-        author: string;
-        assignee: string;
-        commenter: string;
-        involves: string;
-        mentions: string;
-    };
-    git: {
-        head: string;
-        base: string;
-        merged: string;
-        draft: string;
-    };
-    sorting: {
-        sort: string;
-        order: string;
-    };
-    resultLimit: {
-        limit: string;
-    };
-    engagement: {
-        comments: string;
-        reactions: string;
-        interactions: string;
-    };
-    dates: {
-        closed: string;
-        'merged-at': string;
-    };
-    labels: {
-        label: string;
-        'no-label': string;
-        'no-milestone': string;
-        'no-project': string;
-        'no-assignee': string;
-    };
-};
-export declare const GITHUB_SEARCH_CODE: {
-    search: {
-        keywordsToSearch: string;
-    };
-    scope: {
-        owner: string;
-        repo: string;
-    };
-    filters: {
-        extension: string;
-        stars: string;
-        filename: string;
-        path: string;
-        match: string;
-    };
-    resultLimit: {
-        limit: string;
-    };
-    processing: {
-        minify: string;
-        sanitize: string;
-    };
-};
-export declare const GITHUB_SEARCH_REPOS: {
-    search: {
-        keywordsToSearch: string;
-        topicsToSearch: string;
-    };
-    scope: {
-        owner: string;
-    };
-    filters: {
-        stars: string;
-        size: string;
-        created: string;
-        updated: string;
-        match: string;
-    };
-    sorting: {
-        sort: string;
-    };
-    resultLimit: {
-        limit: string;
-    };
-};
-export declare const GITHUB_SEARCH_PULL_REQUESTS: {
-    search: {
-        query: string;
-    };
-    scope: {
-        prNumber: string;
-        owner: string;
-        repo: string;
-    };
-    filters: {
-        state: string;
-        assignee: string;
-        author: string;
-        commenter: string;
-        involves: string;
-        mentions: string;
-        'review-requested': string;
-        'reviewed-by': string;
-        label: string;
-        'no-label': string;
-        'no-milestone': string;
-        'no-project': string;
-        'no-assignee': string;
-        head: string;
-        base: string;
-        created: string;
-        updated: string;
-        closed: string;
-        'merged-at': string;
-        comments: string;
-        reactions: string;
-        interactions: string;
-        merged: string;
-        draft: string;
-        match: string;
-    };
-    sorting: {
-        sort: string;
-        order: string;
-    };
-    resultLimit: {
-        limit: string;
-    };
-    outputShaping: {
-        withComments: string;
-        withContent: string;
-    };
-};
-export declare const GITHUB_FETCH_CONTENT: {
-    scope: {
-        owner: string;
-        repo: string;
-        branch: string;
-        path: string;
-    };
-    processing: {
-        minified: string;
-        sanitize: string;
-    };
-    range: {
-        startLine: string;
-        endLine: string;
-        fullContent: string;
-        matchString: string;
-        matchStringContextLines: string;
-    };
-};
-export declare const GITHUB_VIEW_REPO_STRUCTURE: {
-    scope: {
-        owner: string;
-        repo: string;
-        branch: string;
-        path: string;
-    };
-    range: {
-        depth: string;
-    };
-};

package/dist/src/tools/descriptions.d.ts

@@ -1,7 +0,0 @@
-export declare const DESCRIPTIONS: {
-    githubGetFileContent: string;
-    githubSearchCode: string;
-    githubSearchRepositories: string;
-    githubViewRepoStructure: string;
-    githubSearchPullRequests: string;
-};

package/dist/src/tools/hints.d.ts

@@ -1,29 +0,0 @@
-export declare const TOOL_HINTS: {
-    readonly base: {
-        readonly hasResults: readonly ["Validate results against researchGoal: do findings answer your question? If partial, identify gaps and continue", "Check result quality: verify dates, stars, last activity to ensure code is maintained and relevant", "Include referenced GitHub URLs in output for user navigation", "Got sufficient examples (3+)? Consider stopping to avoid over-research and token waste"];
-        readonly empty: readonly ["No results: Are keywords too specific? Try broader terms or related concepts from domain", "Test filters individually: remove one constraint at a time to identify what blocks results", "Split complex searches: separate concerns into multiple simpler queries"];
-    };
-    readonly githubSearchCode: {
-        readonly hasResults: readonly ["Extract text_matches locations and copy exact match text into FETCH_CONTENT matchString for full context", "Found implementation? Follow imports/dependencies with new searches to understand flow", "Multiple matches? Compare patterns across files to identify common approaches"];
-        readonly empty: readonly ["Current match mode not working? Try the opposite (file↔path) and compare", "Scoped search failed? Drop owner/repo to discover cross-repo patterns, then narrow down", "Apply semantic variants from your domain: expand abbreviations, try synonyms, related terms"];
-    };
-    readonly githubSearchRepositories: {
-        readonly hasResults: readonly ["Validate relevance: fetch README with FETCH_CONTENT to confirm repo matches researchGoal", "Quality check: stars + last_update + topics should align with your requirements", "Map architecture: use VIEW_REPO_STRUCTURE to understand layout, then SEARCH_CODE for implementations", "Multiple repos found? Compare patterns/dependencies/approaches and document key differences"];
-        readonly empty: readonly ["Filters too strict? Test one at a time: relax stars, then size, then dates to find blocking constraint", "Topics not matching? Try keywords search or vice versa - test both approaches", "Expand search terms with domain synonyms (e.g., \"server\"→\"provider\"/\"backend\", \"plugin\"→\"extension\"/\"addon\")", "Try name-only search: match=[\"name\"] can find repos when description search fails"];
-    };
-    readonly githubViewRepoStructure: {
-        readonly hasResults: readonly ["Identified key directories? Convert paths to SEARCH_CODE queries with path+extension filters for targeted search", "Document structure insight: note entry points, config locations, implementation directories, test organization", "Large codebase? Prioritize directories by name relevance to researchGoal (e.g., \"auth\" dir for authentication research)"];
-        readonly empty: readonly ["Path not found? Start at root (path=\"\", depth=1) to see top-level structure", "Monorepo? Check common patterns: packages/, apps/, libs/, modules/, workspaces/", "Verify repo exists: use SEARCH_CODE match=\"path\" to confirm repository accessibility"];
-    };
-    readonly githubGetFileContent: {
-        readonly hasResults: readonly ["Follow code flow: trace imports/dependencies with SEARCH_CODE, then fetch related files with matchString", "Large file result? Use matchString with specific function/class names to reduce tokens and get focused context", "Check if context is sufficient: do you understand the implementation? If not, widen matchStringContextLines or fetch related files"];
-        readonly empty: readonly ["Path invalid? Verify with VIEW_REPO_STRUCTURE or SEARCH_CODE match=\"path\" first", "Branch not found? Omit branch parameter to auto-detect default, or try main/master/develop", "Check path format: no leading slash, use exact case (e.g., \"src/api/auth.ts\" not \"/Src/API/auth.ts\")"];
-    };
-    readonly githubSearchPullRequests: {
-        readonly hasResults: readonly ["Extract implementation insights: examine discussions for rationale, diffs for patterns, review comments for gotchas", "Need code details? Extract changed files/functions and search with SEARCH_CODE or fetch with FETCH_CONTENT", "Token budget tight? Start without withContent/withComments, add only if discussions/diffs are critical", "Multiple PRs? Identify common patterns: same authors, related issues, similar file changes"];
-        readonly empty: readonly ["Search too narrow? Remove constraints progressively: state, then labels, then author, then merged", "Date range limiting results? Widen time window or remove date filters entirely", "Try different search angles: switch from query to author/label filters or vice versa", "Branch-specific work? Add head/base branch filters to find workstream PRs"];
-    };
-};
-export declare const GENERIC_ERROR_HINTS: readonly ["Check authentication token validity and required scopes", "Verify network connectivity and GitHub API status", "Review rate limits and retry after cooldown if exceeded", "Validate input parameters (owner, repo, path, branch) for correctness", "Check repository visibility (public vs private) and access permissions", "Retry the operation after a brief delay for transient errors"];
-export declare function getToolHints(toolName: keyof typeof TOOL_HINTS, resultType: 'hasResults' | 'empty'): readonly string[];
-export declare function getGenericErrorHints(): readonly string[];