octocode-mcp 7.0.12-alpha.1 → 7.0.12-alpha.3

package/dist/src/index.d.ts

@@ -1,2 +1,2 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerAllTools(server: McpServer): Promise<void>;
+export declare function registerAllTools(server: McpServer, _content: import('./tools/toolMetadata.js').CompleteMetadata): Promise<void>;

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

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

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

@@ -1,6 +1,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CompleteMetadata } from '../tools/toolMetadata.js';
 /**
  * Register all prompts with the MCP server
  * Each prompt is defined in its own file under the prompts directory
  */
-export declare function registerPrompts(server: McpServer): void;
+export declare function registerPrompts(server: McpServer, content: CompleteMetadata): void;

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

@@ -1,3 +1,4 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CompleteMetadata } from '../tools/toolMetadata.js';
 export declare const PROMPT_NAME = "research";
-export declare function registerResearchPrompt(server: McpServer): void;
+export declare function registerResearchPrompt(server: McpServer, content: CompleteMetadata): void;

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

@@ -1,3 +1,4 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CompleteMetadata } from '../tools/toolMetadata.js';
 export declare const PROMPT_NAME = "use";
-export declare function registerUsePrompt(server: McpServer): void;
+export declare function registerUsePrompt(server: McpServer, content: CompleteMetadata): void;

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,217 @@
+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;
+        };
+        kudos: {
+            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 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/utils/fetchWithRetries.test.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "octocode-mcp",
-  "version": "7.0.12-alpha.1",
+  "version": "7.0.12-alpha.3",
   "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",

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];