octocode-mcp 9.0.0 → 9.2.0

package/dist/src/types.d.ts

@@ -1,537 +0,0 @@
-import type { GitHubAPIError } from './github/githubAPI.js';
-export type QueryStatus = 'hasResults' | 'empty' | 'error';
-export interface BaseToolResult<TQuery = object> {
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-    error?: string;
-    hints?: string[];
-    query?: TQuery;
-}
-export interface ToolResult {
-    status: QueryStatus;
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-    hints?: string[];
-    [key: string]: unknown;
-}
-export interface ToolErrorResult extends ToolResult {
-    status: 'error';
-    error: string | GitHubAPIError;
-}
-export interface ToolSuccessResult<T = Record<string, unknown>> extends ToolResult {
-    status: 'hasResults' | 'empty';
-    data?: T;
-}
-export interface HintContext {
-    resultType: 'hasResults' | 'empty' | 'failed';
-    apiError?: GitHubAPIError;
-}
-export interface OrganizedHints {
-    hasResults?: string[];
-    empty?: string[];
-    failed?: string[];
-}
-export interface GitHubUserInfo {
-    login: string;
-    id: number;
-    name: string | null;
-    email: string | null;
-    company: string | null;
-    type: 'User' | 'Organization';
-    plan?: {
-        name: string;
-        space: number;
-        private_repos: number;
-    };
-}
-export interface GitHubRateLimitInfo {
-    core: {
-        limit: number;
-        used: number;
-        remaining: number;
-        reset: number;
-    };
-    search: {
-        limit: number;
-        used: number;
-        remaining: number;
-        reset: number;
-    };
-    graphql: {
-        limit: number;
-        used: number;
-        remaining: number;
-        reset: number;
-    };
-}
-export interface GitHubCodeSearchQuery {
-    keywordsToSearch: string[];
-    owner?: string;
-    repo?: string;
-    extension?: string;
-    stars?: string;
-    filename?: string;
-    path?: string;
-    match?: 'file' | 'path';
-    limit?: number;
-    minify?: boolean;
-    sanitize?: boolean;
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-}
-/** Individual file in code search results */
-export interface SearchFile {
-    path: string;
-    text_matches: string[];
-}
-/** Code search result with matched files */
-export interface SearchResult extends BaseToolResult<GitHubCodeSearchQuery> {
-    owner?: string;
-    repo?: string;
-    files: SearchFile[];
-}
-/** Query parameters for fetching file content */
-export interface FileContentQuery {
-    owner: string;
-    repo: string;
-    path: string;
-    branch?: string;
-    fullContent?: boolean;
-    startLine?: number;
-    endLine?: number;
-    matchString?: string;
-    matchStringContextLines?: number;
-    minified?: boolean;
-    sanitize?: boolean;
-    addTimestamp?: boolean;
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-}
-/** LLM sampling metadata for content operations */
-export interface SamplingInfo {
-    samplingId?: string;
-    samplingMethod?: string;
-    samplingTokens?: number;
-    samplingCost?: number;
-    [key: string]: unknown;
-}
-/** File content result data */
-export interface ContentResultData {
-    owner?: string;
-    repo?: string;
-    path?: string;
-    contentLength?: number;
-    content?: string;
-    branch?: string;
-    startLine?: number;
-    endLine?: number;
-    isPartial?: boolean;
-    minified?: boolean;
-    minificationFailed?: boolean;
-    minificationType?: string;
-    originalQuery?: FileContentQuery;
-    securityWarnings?: string[];
-    sampling?: SamplingInfo;
-    lastModified?: string;
-    lastModifiedBy?: string;
-}
-/** Complete file content result */
-export interface ContentResult extends BaseToolResult<FileContentQuery>, ContentResultData {
-}
-/** Query parameters for searching GitHub repositories */
-export interface GitHubReposSearchQuery {
-    keywordsToSearch?: string[];
-    topicsToSearch?: string[];
-    owner?: string;
-    stars?: string;
-    size?: string;
-    created?: string;
-    updated?: string;
-    match?: Array<'name' | 'description' | 'readme'>;
-    sort?: 'forks' | 'stars' | 'updated' | 'best-match';
-    limit?: number;
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-}
-/** Simplified repository metadata */
-export interface SimplifiedRepository {
-    owner: string;
-    repo: string;
-    stars: number;
-    description: string;
-    url: string;
-    createdAt: string;
-    updatedAt: string;
-    pushedAt: string;
-}
-/** Repository search result */
-export interface RepoSearchResult extends BaseToolResult<GitHubReposSearchQuery> {
-    repositories: SimplifiedRepository[];
-}
-/** Query parameters for viewing repository structure */
-export interface GitHubViewRepoStructureQuery {
-    owner: string;
-    repo: string;
-    branch: string;
-    path?: string;
-    depth?: number;
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-}
-/** Repository structure result data */
-export interface RepoStructureResultData {
-    owner?: string;
-    repo?: string;
-    path?: string;
-    files?: string[];
-    folders?: string[];
-}
-/** Complete repository structure result */
-export interface RepoStructureResult extends BaseToolResult<GitHubViewRepoStructureQuery>, RepoStructureResultData {
-}
-/** Query parameters for searching packages */
-export interface PackageSearchQuery {
-    name: string;
-    ecosystem: 'npm' | 'python';
-    searchLimit?: number;
-    npmFetchMetadata?: boolean;
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-}
-/** Individual package in search results */
-export interface PackageInfo {
-    name: string;
-    version: string;
-    description: string | null;
-    keywords: string[];
-    repository: string | null;
-    license?: string;
-    homepage?: string;
-    author?: string;
-}
-/** Package search result data */
-export interface PackageSearchResultData {
-    packages: PackageInfo[];
-    ecosystem: 'npm' | 'python';
-    totalFound: number;
-}
-/** Complete package search result */
-export interface PackageSearchResult extends BaseToolResult<PackageSearchQuery>, PackageSearchResultData {
-}
-/** Query parameters for searching pull requests */
-export interface GitHubPullRequestSearchQuery {
-    query?: string;
-    owner?: string;
-    repo?: string;
-    prNumber?: number;
-    state?: 'open' | 'closed';
-    assignee?: string;
-    author?: string;
-    commenter?: string;
-    involves?: string;
-    mentions?: string;
-    'review-requested'?: string;
-    'reviewed-by'?: string;
-    label?: string | string[];
-    'no-label'?: boolean;
-    'no-milestone'?: boolean;
-    'no-project'?: boolean;
-    'no-assignee'?: boolean;
-    head?: string;
-    base?: string;
-    created?: string;
-    updated?: string;
-    closed?: string;
-    'merged-at'?: string;
-    comments?: number | string;
-    reactions?: number | string;
-    interactions?: number | string;
-    merged?: boolean;
-    draft?: boolean;
-    match?: Array<'title' | 'body' | 'comments'>;
-    sort?: 'created' | 'updated' | 'best-match';
-    order?: 'asc' | 'desc';
-    limit?: number;
-    withComments?: boolean;
-    withCommits?: boolean;
-    type?: 'metadata' | 'fullContent' | 'partialContent';
-    partialContentMetadata?: {
-        file: string;
-        additions?: number[];
-        deletions?: number[];
-    }[];
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-}
-/** Detailed pull request information */
-export interface PullRequestInfo {
-    id: number;
-    number: number;
-    title: string;
-    url: string;
-    html_url: string;
-    state: 'open' | 'closed';
-    draft: boolean;
-    merged: boolean;
-    created_at: string;
-    updated_at: string;
-    closed_at?: string;
-    merged_at?: string;
-    author: {
-        login: string;
-        id: number;
-        avatar_url: string;
-        html_url: string;
-    };
-    assignees?: Array<{
-        login: string;
-        id: number;
-        avatar_url: string;
-        html_url: string;
-    }>;
-    labels?: Array<{
-        id: number;
-        name: string;
-        color: string;
-        description?: string;
-    }>;
-    milestone?: {
-        id: number;
-        title: string;
-        description?: string;
-        state: 'open' | 'closed';
-        created_at: string;
-        updated_at: string;
-        due_on?: string;
-    };
-    head: {
-        ref: string;
-        sha: string;
-        repo?: string;
-    };
-    base: {
-        ref: string;
-        sha: string;
-        repo: string;
-    };
-    body?: string;
-    comments?: number;
-    review_comments?: number;
-    commits?: number;
-    additions?: number;
-    deletions?: number;
-    changed_files?: number;
-    comment_details?: Array<{
-        id: number;
-        user: string;
-        body: string;
-        created_at: string;
-        updated_at: string;
-    }>;
-    file_changes?: Array<{
-        filename: string;
-        status: string;
-        additions: number;
-        deletions: number;
-        changes?: number;
-        patch?: string;
-    }>;
-    commit_details?: Array<{
-        sha: string;
-        message: string;
-        author: string;
-        date: string;
-        files: Array<{
-            filename: string;
-            status: string;
-            additions: number;
-            deletions: number;
-            changes?: number;
-            patch?: string;
-        }>;
-    }>;
-}
-/** Pull request search result data */
-export interface PullRequestSearchResultData {
-    pull_requests?: PullRequestInfo[];
-    total_count?: number;
-    incomplete_results?: boolean;
-}
-/** Complete pull request search result */
-export interface PullRequestSearchResult extends BaseToolResult<GitHubPullRequestSearchQuery>, PullRequestSearchResultData {
-}
-/**
- * Optional callback invoked when a tool is called with queries
- * @param toolName - The name of the tool being invoked
- * @param queries - Array of query objects passed to the tool
- */
-export type ToolInvocationCallback = (toolName: string, queries: unknown[]) => Promise<void>;
-/** Processed result from bulk query execution */
-export interface ProcessedBulkResult<TData = Record<string, unknown>, TQuery = object> {
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-    data?: TData;
-    error?: string | GitHubAPIError;
-    status: QueryStatus;
-    query?: TQuery;
-    hints?: string[];
-    [key: string]: unknown;
-}
-/** Flattened query result for bulk operations */
-export interface FlatQueryResult {
-    status: QueryStatus;
-    data: Record<string, unknown>;
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-}
-/** Error information for failed queries */
-export interface QueryError {
-    queryIndex: number;
-    error: string;
-}
-/** Configuration for bulk response formatting */
-export interface BulkResponseConfig {
-    toolName: string;
-    keysPriority?: string[];
-}
-/** Cache performance statistics */
-export interface CacheStats {
-    hits: number;
-    misses: number;
-    sets: number;
-    totalKeys: number;
-    lastReset: Date;
-}
-/** Result of a promise with error isolation */
-export interface PromiseResult<T> {
-    success: boolean;
-    data?: T;
-    error?: Error;
-    index: number;
-}
-/** Options for batch promise execution */
-export interface PromiseExecutionOptions {
-    timeout?: number;
-    continueOnError?: boolean;
-    concurrency?: number;
-    onError?: (error: Error, index: number) => void;
-}
-/** Standardized tool response format (single and bulk) */
-export interface ToolResponse {
-    data?: unknown;
-    hints?: string[];
-    instructions?: string;
-    results?: unknown[];
-    hasResultsStatusHints?: string[];
-    emptyStatusHints?: string[];
-    errorStatusHints?: string[];
-}
-/** LLM sampling response with token usage */
-export interface SamplingResponse {
-    content: string;
-    stopReason?: string;
-    usage?: {
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
-    };
-}
-/** Pattern definition for detecting sensitive data */
-export interface SensitiveDataPattern {
-    name: string;
-    description: string;
-    regex: RegExp;
-    fileContext?: RegExp;
-    matchAccuracy?: 'high' | 'medium';
-}
-/** Result of content sanitization */
-export interface SanitizationResult {
-    content: string;
-    hasSecrets: boolean;
-    secretsDetected: string[];
-    warnings: string[];
-}
-/** Result of parameter validation */
-export interface ValidationResult {
-    sanitizedParams: Record<string, unknown>;
-    isValid: boolean;
-    hasSecrets: boolean;
-    warnings: string[];
-}
-/** User context for authenticated operations */
-export interface UserContext {
-    userId: string;
-    userLogin: string;
-    organizationId?: string;
-    isEnterpriseMode: boolean;
-    sessionId?: string;
-}
-/** Server configuration and feature flags */
-export interface ServerConfig {
-    version: string;
-    githubApiUrl: string;
-    toolsToRun?: string[];
-    enableTools?: string[];
-    disableTools?: string[];
-    enableLogging: boolean;
-    betaEnabled: boolean;
-    timeout: number;
-    maxRetries: number;
-    loggingEnabled: boolean;
-}
-/** Session data for tracking tool usage */
-export interface SessionData {
-    sessionId: string;
-    intent: 'init' | 'error' | 'tool_call' | 'prompt_call' | 'rate_limit';
-    data: ToolCallData | PromptCallData | ErrorData | RateLimitData | Record<string, never>;
-    timestamp: string;
-    version: string;
-}
-/** Tool call tracking data */
-export interface ToolCallData {
-    tool_name: string;
-    repos: string[];
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-}
-export interface PromptCallData {
-    prompt_name: string;
-}
-/** Error tracking data */
-export interface ErrorData {
-    error: string;
-}
-/** Rate limit tracking data */
-export interface RateLimitData {
-    /**
-     * The kind of rate limit that occurred
-     * - primary: Hourly quota exhausted (REST/GraphQL)
-     * - secondary: Abuse detection (too frequent)
-     * - graphql: GraphQL-specific rate limiting indication
-     * - precheck_blocked: Proactive block based on current rate limits
-     */
-    limit_type: 'primary' | 'secondary' | 'graphql' | 'precheck_blocked';
-    /** Seconds to wait before retrying (if known) */
-    retry_after_seconds?: number;
-    /** Remaining requests at the time of the event */
-    rate_limit_remaining?: number;
-    /** Epoch milliseconds for reset time (if known) */
-    rate_limit_reset_ms?: number;
-    /** Optional HTTP method involved */
-    api_method?: string;
-    /** Optional API URL that was being called */
-    api_url?: string;
-    /** Additional free-form details */
-    details?: string;
-}

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

@@ -1,3 +0,0 @@
-import { CallToolResult } from '@modelcontextprotocol/sdk/types';
-import type { ProcessedBulkResult, BulkResponseConfig } from '../types.js';
-export declare function executeBulkOperation<TQuery extends object, TData = Record<string, unknown>, R extends ProcessedBulkResult<TData, TQuery> = ProcessedBulkResult<TData, TQuery>>(queries: Array<TQuery>, processor: (query: TQuery, index: number) => Promise<R>, config: BulkResponseConfig): Promise<CallToolResult>;

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

@@ -1,22 +0,0 @@
-import type { CacheStats } from '../types.js';
-export declare function generateCacheKey(prefix: string, params: unknown, sessionId?: string): string;
-/**
- * Generic typed cache wrapper for raw data (avoids JSON round-trips)
- */
-export declare function withDataCache<T>(cacheKey: string, operation: () => Promise<T>, options?: {
-    ttl?: number;
-    skipCache?: boolean;
-    forceRefresh?: boolean;
-    shouldCache?: (value: T) => boolean;
-}): Promise<T>;
-/**
- * Clear all cache entries and reset statistics
- */
-export declare function clearAllCache(): void;
-/**
- * Get cache statistics
- */
-export declare function getCacheStats(): CacheStats & {
-    hitRate: number;
-    cacheSize: number;
-};

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

@@ -1 +0,0 @@
-export declare function filterPatch(patch: string, additions?: number[], deletions?: number[]): string;

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

@@ -1,25 +0,0 @@
-export declare function getGithubCLIToken(): Promise<string | null>;
-declare const ALLOWED_NPM_COMMANDS: readonly ["view", "search", "ping", "config", "whoami"];
-type NpmCommand = (typeof ALLOWED_NPM_COMMANDS)[number];
-type NpmExecOptions = {
-    timeout?: number;
-    cwd?: string;
-    env?: Record<string, string>;
-};
-interface NpmExecResult {
-    stdout: string;
-    stderr: string;
-    error?: Error;
-    exitCode?: number;
-}
-/**
- * Check if npm registry is available by running `npm ping`
- * @param timeoutMs - Timeout in milliseconds (default 10000ms)
- * @returns true if npm registry is reachable, false otherwise
- */
-export declare function checkNpmAvailability(timeoutMs?: number): Promise<boolean>;
-/**
- * Execute NPM command with security validation using spawn (safer than exec)
- */
-export declare function executeNpmCommand(command: NpmCommand, args: string[], options?: NpmExecOptions): Promise<NpmExecResult>;
-export {};

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

@@ -1,52 +0,0 @@
-/**
- * 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;
-    /**
-     * Whether to include the package version as a query parameter
-     * @default false
-     */
-    includeVersion?: boolean;
-}
-/**
- * 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/src/utils/fileFilters.d.ts

@@ -1,19 +0,0 @@
-/**
- * Folder names to ignore (exact matches)
- */
-export declare const IGNORED_FOLDER_NAMES: string[];
-export declare const IGNORED_FILE_NAMES: string[];
-/**
- * File extensions to ignore
- */
-export declare const IGNORED_FILE_EXTENSIONS: string[];
-/**
- * Check if a directory should be ignored based on folder name
- */
-export declare function shouldIgnoreDir(folderName: string): boolean;
-/**
- * Check if a file should be ignored based on file name, extension, and path
- * Optimized order: extension (fastest) → file name → path (most expensive)
- * @param filePath - Full file path (e.g., ".yarn/x/y/z.js")
- */
-export declare function shouldIgnoreFile(filePath: string): boolean;

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

@@ -1,17 +0,0 @@
-import type { NpmPackageResult } from './package.js';
-/**
- * Attempts to infer the GitHub repository for an npm package
- * when the npm registry doesn't have the repository field.
- *
- * Uses heuristics and known mappings - no API calls required.
- */
-export declare function tryInferRepoUrl(packageName: string, existingResult: NpmPackageResult): NpmPackageResult;
-/**
- * Add a new known package to repo mapping at runtime.
- * Useful for caching discovered mappings.
- */
-export declare function addKnownPackageRepo(packageName: string, repoUrl: string): void;
-/**
- * Get the GitHub organization for a given npm scope.
- */
-export declare function getOrgForScope(scope: string): string | undefined;