octocode-mcp 9.0.0-alpha.2 → 9.2.0

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

@@ -1,196 +0,0 @@
-import { z } from 'zod';
-declare const NpmPackageQuerySchema: z.ZodObject<{
-    mainResearchGoal: z.ZodString;
-    researchGoal: z.ZodString;
-    reasoning: z.ZodString;
-} & {
-    name: z.ZodString;
-    searchLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    npmFetchMetadata: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    mainResearchGoal: string;
-    researchGoal: string;
-    reasoning: string;
-    searchLimit: number;
-    npmFetchMetadata: boolean;
-}, {
-    name: string;
-    mainResearchGoal: string;
-    researchGoal: string;
-    reasoning: string;
-    searchLimit?: number | undefined;
-    npmFetchMetadata?: boolean | undefined;
-}>;
-declare const PythonPackageQuerySchema: z.ZodObject<{
-    mainResearchGoal: z.ZodString;
-    researchGoal: z.ZodString;
-    reasoning: z.ZodString;
-} & {
-    name: z.ZodString;
-    searchLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    pythonFetchMetadata: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    mainResearchGoal: string;
-    researchGoal: string;
-    reasoning: string;
-    searchLimit: number;
-    pythonFetchMetadata: boolean;
-}, {
-    name: string;
-    mainResearchGoal: string;
-    researchGoal: string;
-    reasoning: string;
-    searchLimit?: number | undefined;
-    pythonFetchMetadata?: boolean | undefined;
-}>;
-export declare const PackageSearchQuerySchema: z.ZodDiscriminatedUnion<"ecosystem", [z.ZodObject<{
-    mainResearchGoal: z.ZodString;
-    researchGoal: z.ZodString;
-    reasoning: z.ZodString;
-} & {
-    name: z.ZodString;
-    searchLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    npmFetchMetadata: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-} & {
-    ecosystem: z.ZodLiteral<"npm">;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    mainResearchGoal: string;
-    researchGoal: string;
-    reasoning: string;
-    searchLimit: number;
-    npmFetchMetadata: boolean;
-    ecosystem: "npm";
-}, {
-    name: string;
-    mainResearchGoal: string;
-    researchGoal: string;
-    reasoning: string;
-    ecosystem: "npm";
-    searchLimit?: number | undefined;
-    npmFetchMetadata?: boolean | undefined;
-}>, z.ZodObject<{
-    mainResearchGoal: z.ZodString;
-    researchGoal: z.ZodString;
-    reasoning: z.ZodString;
-} & {
-    name: z.ZodString;
-    searchLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    pythonFetchMetadata: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-} & {
-    ecosystem: z.ZodLiteral<"python">;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    mainResearchGoal: string;
-    researchGoal: string;
-    reasoning: string;
-    searchLimit: number;
-    pythonFetchMetadata: boolean;
-    ecosystem: "python";
-}, {
-    name: string;
-    mainResearchGoal: string;
-    researchGoal: string;
-    reasoning: string;
-    ecosystem: "python";
-    searchLimit?: number | undefined;
-    pythonFetchMetadata?: boolean | undefined;
-}>]>;
-export declare const PackageSearchBulkQuerySchema: z.ZodObject<{
-    queries: z.ZodArray<z.ZodDiscriminatedUnion<"ecosystem", [z.ZodObject<{
-        mainResearchGoal: z.ZodString;
-        researchGoal: z.ZodString;
-        reasoning: z.ZodString;
-    } & {
-        name: z.ZodString;
-        searchLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-        npmFetchMetadata: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    } & {
-        ecosystem: z.ZodLiteral<"npm">;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        mainResearchGoal: string;
-        researchGoal: string;
-        reasoning: string;
-        searchLimit: number;
-        npmFetchMetadata: boolean;
-        ecosystem: "npm";
-    }, {
-        name: string;
-        mainResearchGoal: string;
-        researchGoal: string;
-        reasoning: string;
-        ecosystem: "npm";
-        searchLimit?: number | undefined;
-        npmFetchMetadata?: boolean | undefined;
-    }>, z.ZodObject<{
-        mainResearchGoal: z.ZodString;
-        researchGoal: z.ZodString;
-        reasoning: z.ZodString;
-    } & {
-        name: z.ZodString;
-        searchLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-        pythonFetchMetadata: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    } & {
-        ecosystem: z.ZodLiteral<"python">;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        mainResearchGoal: string;
-        researchGoal: string;
-        reasoning: string;
-        searchLimit: number;
-        pythonFetchMetadata: boolean;
-        ecosystem: "python";
-    }, {
-        name: string;
-        mainResearchGoal: string;
-        researchGoal: string;
-        reasoning: string;
-        ecosystem: "python";
-        searchLimit?: number | undefined;
-        pythonFetchMetadata?: boolean | undefined;
-    }>]>, "many">;
-}, "strip", z.ZodTypeAny, {
-    queries: ({
-        name: string;
-        mainResearchGoal: string;
-        researchGoal: string;
-        reasoning: string;
-        searchLimit: number;
-        npmFetchMetadata: boolean;
-        ecosystem: "npm";
-    } | {
-        name: string;
-        mainResearchGoal: string;
-        researchGoal: string;
-        reasoning: string;
-        searchLimit: number;
-        pythonFetchMetadata: boolean;
-        ecosystem: "python";
-    })[];
-}, {
-    queries: ({
-        name: string;
-        mainResearchGoal: string;
-        researchGoal: string;
-        reasoning: string;
-        ecosystem: "npm";
-        searchLimit?: number | undefined;
-        npmFetchMetadata?: boolean | undefined;
-    } | {
-        name: string;
-        mainResearchGoal: string;
-        researchGoal: string;
-        reasoning: string;
-        ecosystem: "python";
-        searchLimit?: number | undefined;
-        pythonFetchMetadata?: boolean | undefined;
-    })[];
-}>;
-export type NpmPackageQuery = z.infer<typeof NpmPackageQuerySchema>;
-export type PythonPackageQuery = z.infer<typeof PythonPackageQuerySchema>;
-export type PackageSearchQuery = z.infer<typeof PackageSearchQuerySchema>;
-export type PackageSearchBulkParams = z.infer<typeof PackageSearchBulkQuerySchema>;
-export {};

package/dist/src/security/contentSanitizer.d.ts

@@ -1,6 +0,0 @@
-import type { SanitizationResult, ValidationResult } from '../types.js';
-export declare class ContentSanitizer {
-    static sanitizeContent(content: string): SanitizationResult;
-    private static detectSecrets;
-    static validateInputParameters(params: Record<string, unknown>): ValidationResult;
-}

package/dist/src/security/mask.d.ts

@@ -1 +0,0 @@
-export declare function maskSensitiveData(text: string): string;

package/dist/src/security/regexes.d.ts

@@ -1,2 +0,0 @@
-import type { SensitiveDataPattern } from '../types.js';
-export declare const allRegexPatterns: SensitiveDataPattern[];

package/dist/src/security/withSecurityValidation.d.ts

@@ -1,86 +0,0 @@
-import { CallToolResult } from '@modelcontextprotocol/sdk/types';
-import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
-export declare function withSecurityValidation<T extends Record<string, unknown>>(toolName: string, toolHandler: (sanitizedArgs: T, authInfo?: AuthInfo, sessionId?: string) => Promise<CallToolResult>): (args: unknown, { authInfo, sessionId }: {
-    authInfo?: AuthInfo;
-    sessionId?: string;
-}) => Promise<CallToolResult>;
-export declare function withBasicSecurityValidation<T extends Record<string, unknown>>(toolHandler: (sanitizedArgs: T) => Promise<CallToolResult>): (args: unknown) => Promise<CallToolResult>;
-/**
- * Extracts research fields from a single query object.
- * Used for logging individual queries in bulk operations.
- */
-export declare function extractResearchFieldsFromSingleQuery(query: Record<string, unknown>): {
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-};
-export declare function extractResearchFields(params: Record<string, unknown>): {
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-};
-/**
- * Extracts repository identifiers from a single query object.
- * Used for logging individual queries in bulk operations.
- *
- * Supports multiple parameter formats:
- * - Combined repository field: `repository: "owner/repo"`
- * - Separate owner/repo fields: `owner: "owner", repo: "repo"`
- * - Owner only: `owner: "owner"` (for tools like github_search_repos)
- *
- * @param query - A single query object containing repository information
- * @returns Array of repository identifiers (typically one, but can be multiple for some tools)
- *
- * @example
- * extractRepoOwnerFromSingleQuery({ repository: "facebook/react" })
- * // Returns: ["facebook/react"]
- *
- * @example
- * extractRepoOwnerFromSingleQuery({ owner: "microsoft", repo: "vscode" })
- * // Returns: ["microsoft/vscode"]
- *
- * @example
- * extractRepoOwnerFromSingleQuery({ owner: "vercel" })
- * // Returns: ["vercel"]
- */
-export declare function extractRepoOwnerFromSingleQuery(query: Record<string, unknown>): string[];
-/**
- * Extracts repository identifiers from tool parameters for logging purposes.
- *
- * Supports multiple parameter formats:
- * - Combined repository field: `repository: "owner/repo"`
- * - Separate owner/repo fields: `owner: "owner", repo: "repo"`
- * - Owner only: `owner: "owner"` (for tools like github_search_repos)
- *
- * Works with both bulk operations (queries array) and single operations (direct params).
- *
- * @param params - The tool parameters containing repository information
- * @returns Array of unique repository identifiers (e.g., ["owner/repo", "owner2/repo2", "owner3"])
- *
- * @example
- * // Combined repository format
- * extractRepoOwnerFromParams({ queries: [{ repository: "facebook/react" }] })
- * // Returns: ["facebook/react"]
- *
- * @example
- * // Separate owner/repo format
- * extractRepoOwnerFromParams({ queries: [{ owner: "microsoft", repo: "vscode" }] })
- * // Returns: ["microsoft/vscode"]
- *
- * @example
- * // Owner only format (for repository search)
- * extractRepoOwnerFromParams({ queries: [{ owner: "vercel" }] })
- * // Returns: ["vercel"]
- *
- * @example
- * // Multiple queries with mixed formats
- * extractRepoOwnerFromParams({
- *   queries: [
- *     { repository: "facebook/react" },
- *     { owner: "microsoft", repo: "vscode" },
- *     { owner: "vercel" }
- *   ]
- * })
- * // Returns: ["facebook/react", "microsoft/vscode", "vercel"]
- */
-export declare function extractRepoOwnerFromParams(params: Record<string, unknown>): string[];

package/dist/src/serverConfig.d.ts

@@ -1,12 +0,0 @@
-import type { ServerConfig } from './types.js';
-declare function parseStringArray(value?: string): string[] | undefined;
-export declare function initialize(): Promise<void>;
-export declare function cleanup(): void;
-export declare function getServerConfig(): ServerConfig;
-export declare function getGitHubToken(): Promise<string | null>;
-export declare function getToken(): Promise<string>;
-export declare function isBetaEnabled(): boolean;
-export declare function isSamplingEnabled(): boolean;
-export declare function isLoggingEnabled(): boolean;
-export declare function clearCachedToken(): void;
-export { parseStringArray };

package/dist/src/session.d.ts

@@ -1,22 +0,0 @@
-import type { RateLimitData } from './types.js';
-declare class SessionManager {
-    private sessionId;
-    private readonly logEndpoint;
-    constructor();
-    getSessionId(): string;
-    logInit(): Promise<void>;
-    logToolCall(toolName: string, repos: string[], mainResearchGoal?: string, researchGoal?: string, reasoning?: string): Promise<void>;
-    logPromptCall(promptName: string): Promise<void>;
-    logError(toolName: string, errorCode: string): Promise<void>;
-    logRateLimit(data: RateLimitData): Promise<void>;
-    private sendLog;
-}
-export declare function initializeSession(): SessionManager;
-export declare function getSessionManager(): SessionManager | null;
-export declare function logSessionInit(): Promise<void>;
-export declare function logToolCall(toolName: string, repos: string[], mainResearchGoal?: string, researchGoal?: string, reasoning?: string): Promise<void>;
-export declare function logPromptCall(promptName: string): Promise<void>;
-export declare function logSessionError(toolName: string, errorCode: string): Promise<void>;
-export declare function logRateLimit(data: RateLimitData): Promise<void>;
-export declare function resetSessionManager(): void;
-export {};

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

@@ -1,3 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { ToolInvocationCallback } from '../types.js';
-export declare function registerFetchGitHubFileContentTool(server: McpServer, callback?: ToolInvocationCallback): import("@modelcontextprotocol/sdk/server/mcp.js").RegisteredTool;

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

@@ -1,3 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { ToolInvocationCallback } from '../types.js';
-export declare function registerGitHubSearchCodeTool(server: McpServer, callback?: ToolInvocationCallback): import("@modelcontextprotocol/sdk/server/mcp.js").RegisteredTool;

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

@@ -1,3 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { ToolInvocationCallback } from '../types.js';
-export declare function registerSearchGitHubPullRequestsTool(server: McpServer, callback?: ToolInvocationCallback): import("@modelcontextprotocol/sdk/server/mcp.js").RegisteredTool;

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

@@ -1,3 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { ToolInvocationCallback } from '../types.js';
-export declare function registerSearchGitHubReposTool(server: McpServer, callback?: ToolInvocationCallback): import("@modelcontextprotocol/sdk/server/mcp.js").RegisteredTool;

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

@@ -1,3 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { ToolInvocationCallback } from '../types.js';
-export declare function registerViewGitHubRepoStructureTool(server: McpServer, callback?: ToolInvocationCallback): import("@modelcontextprotocol/sdk/server/mcp.js").RegisteredTool;

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

@@ -1,3 +0,0 @@
-import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { ToolInvocationCallback } from '../types.js';
-export declare function registerPackageSearchTool(server: McpServer, callback?: ToolInvocationCallback): Promise<RegisteredTool | null>;

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

@@ -1,16 +0,0 @@
-import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { ToolInvocationCallback } from '../types.js';
-export interface ToolConfig {
-    name: string;
-    description: string;
-    isDefault: boolean;
-    type: 'search' | 'content' | 'history' | 'debug';
-    fn: (server: McpServer, callback?: ToolInvocationCallback) => RegisteredTool | Promise<RegisteredTool | null>;
-}
-export declare const GITHUB_SEARCH_CODE: ToolConfig;
-export declare const GITHUB_FETCH_CONTENT: ToolConfig;
-export declare const GITHUB_VIEW_REPO_STRUCTURE: ToolConfig;
-export declare const GITHUB_SEARCH_REPOSITORIES: ToolConfig;
-export declare const GITHUB_SEARCH_PULL_REQUESTS: ToolConfig;
-export declare const PACKAGE_SEARCH: ToolConfig;
-export declare const DEFAULT_TOOLS: ToolConfig[];

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

@@ -1,207 +0,0 @@
-export interface PromptArgument {
-    name: string;
-    description: string;
-    required?: boolean;
-}
-export interface PromptMetadata {
-    name: string;
-    description: string;
-    content: string;
-    args?: PromptArgument[];
-}
-export interface ToolMetadata {
-    name: string;
-    description: string;
-    schema: Record<string, string>;
-    hints: {
-        hasResults: readonly string[];
-        empty: readonly string[];
-    };
-}
-export interface CompleteMetadata {
-    instructions: string;
-    prompts: Record<string, PromptMetadata>;
-    toolNames: {
-        GITHUB_FETCH_CONTENT: 'githubGetFileContent';
-        GITHUB_SEARCH_CODE: 'githubSearchCode';
-        GITHUB_SEARCH_PULL_REQUESTS: 'githubSearchPullRequests';
-        GITHUB_SEARCH_REPOSITORIES: 'githubSearchRepositories';
-        GITHUB_VIEW_REPO_STRUCTURE: 'githubViewRepoStructure';
-        PACKAGE_SEARCH: 'packageSearch';
-    };
-    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[];
-}
-type ToolNamesValue = CompleteMetadata['toolNames'][keyof CompleteMetadata['toolNames']];
-export type ToolName = ToolNamesValue;
-export declare function initializeToolMetadata(): Promise<void>;
-export declare function loadToolContent(): Promise<CompleteMetadata>;
-export declare const TOOL_NAMES: CompleteMetadata["toolNames"];
-export declare const BASE_SCHEMA: CompleteMetadata["baseSchema"];
-export declare const GENERIC_ERROR_HINTS: readonly string[];
-export declare function isToolAvailableSync(toolName: string): boolean;
-export declare function getToolHintsSync(toolName: string, resultType: 'hasResults' | 'empty'): readonly string[];
-export declare function getGenericErrorHintsSync(): readonly string[];
-export declare function getDynamicHints(toolName: string, hintType: 'topicsHasResults' | 'topicsEmpty' | 'keywordsEmpty'): readonly 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;
-        addTimestamp: 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;
-        repo: 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;
-        withCommits: string;
-        type: string;
-        partialContentMetadata: string;
-    };
-};
-export declare const GITHUB_VIEW_REPO_STRUCTURE: {
-    scope: {
-        owner: string;
-        repo: string;
-        branch: string;
-        path: string;
-    };
-    range: {
-        depth: string;
-    };
-};
-export declare const PACKAGE_SEARCH: {
-    search: {
-        ecosystem: string;
-        name: string;
-    };
-    options: {
-        searchLimit: string;
-        npmFetchMetadata: string;
-        pythonFetchMetadata: string;
-    };
-};
-export {};

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

@@ -1,6 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { ToolInvocationCallback } from '../types.js';
-export declare function registerTools(server: McpServer, callback?: ToolInvocationCallback): {
-    successCount: number;
-    failedTools: string[];
-};

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

@@ -1,23 +0,0 @@
-import type { GitHubAPIError } from '../github/githubAPI';
-import type { ToolErrorResult, ToolSuccessResult } from '../types.js';
-import { TOOL_NAMES } from './toolMetadata.js';
-export declare function createErrorResult(query: {
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-}, error: string | GitHubAPIError, apiError?: GitHubAPIError): ToolErrorResult;
-export declare function createSuccessResult<T>(query: {
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-}, data: T, hasContent: boolean, _toolName: keyof typeof TOOL_NAMES, customHints?: string[]): ToolSuccessResult<T extends Record<string, unknown> ? T : never> & T;
-export declare function handleApiError(apiResult: unknown, query: {
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-}): ToolErrorResult | null;
-export declare function handleCatchError(error: unknown, query: {
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-}, contextMessage?: string): ToolErrorResult;