octocode-mcp 7.0.11 → 7.0.12-alpha.2

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

@@ -67,23 +67,23 @@ export declare const GitHubPullRequestSearchQuerySchema: z.ZodObject<{
     repo?: string | undefined;
     sort?: "created" | "updated" | "best-match" | undefined;
     head?: string | undefined;
-    'no-label'?: boolean | undefined;
-    'no-milestone'?: boolean | undefined;
-    'no-project'?: boolean | undefined;
-    'no-assignee'?: boolean | undefined;
-    'merged-at'?: string | undefined;
+    base?: string | undefined;
     match?: ("title" | "body" | "comments")[] | undefined;
     limit?: number | undefined;
     merged?: boolean | undefined;
+    'merged-at'?: string | undefined;
     author?: string | undefined;
     mentions?: string | undefined;
     commenter?: string | undefined;
     involves?: string | undefined;
     'reviewed-by'?: string | undefined;
     'review-requested'?: string | undefined;
-    base?: string | undefined;
     interactions?: string | number | undefined;
     label?: string | string[] | undefined;
+    'no-assignee'?: boolean | undefined;
+    'no-label'?: boolean | undefined;
+    'no-milestone'?: boolean | undefined;
+    'no-project'?: boolean | undefined;
     prNumber?: number | undefined;
     withComments?: boolean | undefined;
     withContent?: boolean | undefined;
@@ -104,23 +104,23 @@ export declare const GitHubPullRequestSearchQuerySchema: z.ZodObject<{
     repo?: string | undefined;
     sort?: "created" | "updated" | "best-match" | undefined;
     head?: string | undefined;
-    'no-label'?: boolean | undefined;
-    'no-milestone'?: boolean | undefined;
-    'no-project'?: boolean | undefined;
-    'no-assignee'?: boolean | undefined;
-    'merged-at'?: string | undefined;
+    base?: string | undefined;
     match?: ("title" | "body" | "comments")[] | undefined;
     limit?: number | undefined;
     merged?: boolean | undefined;
+    'merged-at'?: string | undefined;
     author?: string | undefined;
     mentions?: string | undefined;
     commenter?: string | undefined;
     involves?: string | undefined;
     'reviewed-by'?: string | undefined;
     'review-requested'?: string | undefined;
-    base?: string | undefined;
     interactions?: string | number | undefined;
     label?: string | string[] | undefined;
+    'no-assignee'?: boolean | undefined;
+    'no-label'?: boolean | undefined;
+    'no-milestone'?: boolean | undefined;
+    'no-project'?: boolean | undefined;
     order?: "asc" | "desc" | undefined;
     prNumber?: number | undefined;
     withComments?: boolean | undefined;
@@ -184,23 +184,23 @@ export declare const GitHubPullRequestSearchBulkQuerySchema: z.ZodObject<{
         repo?: string | undefined;
         sort?: "created" | "updated" | "best-match" | undefined;
         head?: string | undefined;
-        'no-label'?: boolean | undefined;
-        'no-milestone'?: boolean | undefined;
-        'no-project'?: boolean | undefined;
-        'no-assignee'?: boolean | undefined;
-        'merged-at'?: string | undefined;
+        base?: string | undefined;
         match?: ("title" | "body" | "comments")[] | undefined;
         limit?: number | undefined;
         merged?: boolean | undefined;
+        'merged-at'?: string | undefined;
         author?: string | undefined;
         mentions?: string | undefined;
         commenter?: string | undefined;
         involves?: string | undefined;
         'reviewed-by'?: string | undefined;
         'review-requested'?: string | undefined;
-        base?: string | undefined;
         interactions?: string | number | undefined;
         label?: string | string[] | undefined;
+        'no-assignee'?: boolean | undefined;
+        'no-label'?: boolean | undefined;
+        'no-milestone'?: boolean | undefined;
+        'no-project'?: boolean | undefined;
         prNumber?: number | undefined;
         withComments?: boolean | undefined;
         withContent?: boolean | undefined;
@@ -221,23 +221,23 @@ export declare const GitHubPullRequestSearchBulkQuerySchema: z.ZodObject<{
         repo?: string | undefined;
         sort?: "created" | "updated" | "best-match" | undefined;
         head?: string | undefined;
-        'no-label'?: boolean | undefined;
-        'no-milestone'?: boolean | undefined;
-        'no-project'?: boolean | undefined;
-        'no-assignee'?: boolean | undefined;
-        'merged-at'?: string | undefined;
+        base?: string | undefined;
         match?: ("title" | "body" | "comments")[] | undefined;
         limit?: number | undefined;
         merged?: boolean | undefined;
+        'merged-at'?: string | undefined;
         author?: string | undefined;
         mentions?: string | undefined;
         commenter?: string | undefined;
         involves?: string | undefined;
         'reviewed-by'?: string | undefined;
         'review-requested'?: string | undefined;
-        base?: string | undefined;
         interactions?: string | number | undefined;
         label?: string | string[] | undefined;
+        'no-assignee'?: boolean | undefined;
+        'no-label'?: boolean | undefined;
+        'no-milestone'?: boolean | undefined;
+        'no-project'?: boolean | undefined;
         order?: "asc" | "desc" | undefined;
         prNumber?: number | undefined;
         withComments?: boolean | undefined;
@@ -262,23 +262,23 @@ export declare const GitHubPullRequestSearchBulkQuerySchema: z.ZodObject<{
         repo?: string | undefined;
         sort?: "created" | "updated" | "best-match" | undefined;
         head?: string | undefined;
-        'no-label'?: boolean | undefined;
-        'no-milestone'?: boolean | undefined;
-        'no-project'?: boolean | undefined;
-        'no-assignee'?: boolean | undefined;
-        'merged-at'?: string | undefined;
+        base?: string | undefined;
         match?: ("title" | "body" | "comments")[] | undefined;
         limit?: number | undefined;
         merged?: boolean | undefined;
+        'merged-at'?: string | undefined;
         author?: string | undefined;
         mentions?: string | undefined;
         commenter?: string | undefined;
         involves?: string | undefined;
         'reviewed-by'?: string | undefined;
         'review-requested'?: string | undefined;
-        base?: string | undefined;
         interactions?: string | number | undefined;
         label?: string | string[] | undefined;
+        'no-assignee'?: boolean | undefined;
+        'no-label'?: boolean | undefined;
+        'no-milestone'?: boolean | undefined;
+        'no-project'?: boolean | undefined;
         prNumber?: number | undefined;
         withComments?: boolean | undefined;
         withContent?: boolean | undefined;
@@ -301,23 +301,23 @@ export declare const GitHubPullRequestSearchBulkQuerySchema: z.ZodObject<{
         repo?: string | undefined;
         sort?: "created" | "updated" | "best-match" | undefined;
         head?: string | undefined;
-        'no-label'?: boolean | undefined;
-        'no-milestone'?: boolean | undefined;
-        'no-project'?: boolean | undefined;
-        'no-assignee'?: boolean | undefined;
-        'merged-at'?: string | undefined;
+        base?: string | undefined;
         match?: ("title" | "body" | "comments")[] | undefined;
         limit?: number | undefined;
         merged?: boolean | undefined;
+        'merged-at'?: string | undefined;
         author?: string | undefined;
         mentions?: string | undefined;
         commenter?: string | undefined;
         involves?: string | undefined;
         'reviewed-by'?: string | undefined;
         'review-requested'?: string | undefined;
-        base?: string | undefined;
         interactions?: string | number | undefined;
         label?: string | string[] | undefined;
+        'no-assignee'?: boolean | undefined;
+        'no-label'?: boolean | undefined;
+        'no-milestone'?: boolean | undefined;
+        'no-project'?: boolean | undefined;
         order?: "asc" | "desc" | undefined;
         prNumber?: number | undefined;
         withComments?: boolean | undefined;

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

@@ -0,0 +1,203 @@
+export interface ToolMetadata {
+    name: string;
+    description: string;
+    schema: Record<string, string>;
+    hints: {
+        hasResults: readonly string[];
+        empty: readonly string[];
+    };
+}
+export interface CompleteMetadata {
+    instructions: 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 const INSTRUCTIONS: string;
+export declare const TOOL_NAMES: {
+    GITHUB_FETCH_CONTENT: "githubGetFileContent";
+    GITHUB_SEARCH_CODE: "githubSearchCode";
+    GITHUB_SEARCH_PULL_REQUESTS: "githubSearchPullRequests";
+    GITHUB_SEARCH_REPOSITORIES: "githubSearchRepositories";
+    GITHUB_VIEW_REPO_STRUCTURE: "githubViewRepoStructure";
+};
+export type ToolName = (typeof TOOL_NAMES)[keyof typeof TOOL_NAMES];
+export declare const BASE_SCHEMA: {
+    mainResearchGoal: string;
+    researchGoal: string;
+    reasoning: string;
+    bulkQuery: (toolName: string) => string;
+};
+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 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/tests/tools/github_search_code.match_modes.test.d.ts

@@ -18,9 +18,5 @@
  * - This makes sense: you're finding files by name, not searching their content!
  *
  * Test Results from Actual Octocode MCP Server (Verified):
- * ✅ match='file' searches IN file content and returns paths WITH text_matches
- * ✅ match='path' searches in filenames/directories and returns ONLY paths (no text_matches)
- * ✅ Multiple paths are returned when match='path' finds multiple matches
- * ✅ Both modes work correctly in bulk operations
  */
 export {};

package/dist/tests/tools/response_structure.test.d.ts

@@ -8,11 +8,5 @@
  *
  * Combinations tested:
  * 1. hasResults only
- * 2. empty only
- * 3. failed only
- * 4. hasResults + empty
- * 5. hasResults + failed
- * 6. empty + failed
- * 7. hasResults + empty + failed
  */
 export {};

package/dist/tests/utils/testHelpers.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Test helpers for type guards and common test utilities
+ */
+import type { ContentBlock } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Type guard to check if a ContentBlock is TextContent
+ */
+export declare function isTextContent(content: ContentBlock | undefined): content is {
+    type: 'text';
+    text: string;
+};
+/**
+ * Extracts text from a ContentBlock array, asserting it's text content
+ * @throws Error if content is not text type
+ */
+export declare function getTextContent(content: ContentBlock[]): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "octocode-mcp",
-  "version": "7.0.11",
+  "version": "7.0.12-alpha.2",
   "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",
@@ -39,32 +39,27 @@
     "octocode-mcp-beta": "dist/index.js"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.21.0",
+    "@modelcontextprotocol/sdk": "^1.22.0",
     "@octokit/core": "^7.0.6",
-    "@octokit/openapi-types": "^25.1.0",
-    "@octokit/plugin-rest-endpoint-methods": "^14.0.0",
-    "@octokit/plugin-throttling": "^11.0.1",
-    "@octokit/rest": "^22.0.0",
-    "async-mutex": "^0.5.0",
-    "axios": "^1.12.2",
-    "dotenv": "^16.4.5",
-    "express": "^4.18.2",
-    "mcp-s-oauth": "^1.0.5",
+    "@octokit/openapi-types": "^27.0.0",
+    "@octokit/plugin-rest-endpoint-methods": "^17.0.0",
+    "@octokit/plugin-throttling": "^11.0.3",
+    "axios": "^1.13.2",
+    "dotenv": "^17.2.3",
+    "express": "^5.1.0",
     "node-cache": "^5.1.2",
-    "node-fetch": "^3.3.2",
-    "octocode-utils": "^5.0.0",
+    "octocode-utils": "latest",
     "octokit": "^5.0.5",
     "uuid": "^13.0.0",
-    "zod": "^3.25.26"
+    "zod": "^3.23.8"
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^28.0.3",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.1",
     "@rollup/plugin-typescript": "^12.1.2",
-    "@types/express": "^5.0.3",
+    "@types/express": "^5",
     "@types/node": "^22.15.29",
-    "@types/uuid": "^11.0.0",
     "eslint": "^8.57.0",
     "eslint-config-prettier": "^10.1.5",
     "eslint-plugin-prettier": "^5.4.1",
@@ -112,5 +107,6 @@
     "type": "stdio",
     "command": "octocode-mcp",
     "args": []
-  }
-}
+  },
+  "stableVersion": "7.0.12"
+}

package/server.json

@@ -8,12 +8,12 @@
     "url": "https://github.com/bgauryy/octocode-mcp",
     "source": "github"
   },
-  "version": "7.0.11",
+  "version": "7.0.12",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "octocode-mcp",
-      "version": "7.0.11",
+      "version": "7.0.12",
       "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/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;
-    };
-};