@octocodeai/octocode-tools-core 16.2.0

package/dist/errors/ToolError.d.ts

@@ -0,0 +1,21 @@
+import { LocalToolErrorCategory, type LocalToolErrorCode } from './localToolErrors.js';
+export declare class ToolError extends Error {
+    readonly errorCode: LocalToolErrorCode;
+    readonly category: LocalToolErrorCategory;
+    readonly recoverability: 'recoverable' | 'unrecoverable' | 'user-action-required';
+    readonly context?: Record<string, unknown>;
+    constructor(errorCode: LocalToolErrorCode, message?: string, context?: Record<string, unknown>, cause?: Error);
+    isRecoverable(): boolean;
+    requiresUserAction(): boolean;
+    toJSON(): {
+        name: string;
+        errorCode: LocalToolErrorCode;
+        category: LocalToolErrorCategory;
+        message: string;
+        recoverability: "recoverable" | "unrecoverable" | "user-action-required";
+        context: Record<string, unknown>;
+        stack: string;
+    };
+}
+export declare function isToolError(error: unknown): error is ToolError;
+export declare function toToolError(error: unknown, defaultErrorCode?: LocalToolErrorCode, context?: Record<string, unknown>): ToolError;

package/dist/errors/domainErrors.d.ts

@@ -0,0 +1,310 @@
+export declare const CONFIG_ERRORS: {
+    readonly NOT_INITIALIZED: {
+        readonly code: "CONFIG_NOT_INITIALIZED";
+        readonly message: "Configuration not initialized. Call initialize() and await its completion before calling getServerConfig().";
+    };
+};
+export declare const VALIDATION_ERRORS: {
+    readonly PROMISES_NOT_ARRAY: {
+        readonly code: "VALIDATION_PROMISES_NOT_ARRAY";
+        readonly message: "promises must be an array";
+    };
+    readonly TIMEOUT_NOT_POSITIVE: {
+        readonly code: "VALIDATION_TIMEOUT_NOT_POSITIVE";
+        readonly message: "timeout must be positive";
+    };
+    readonly CONCURRENCY_NOT_POSITIVE: {
+        readonly code: "VALIDATION_CONCURRENCY_NOT_POSITIVE";
+        readonly message: "concurrency must be positive";
+    };
+};
+export declare const FETCH_ERRORS: {
+    readonly FETCH_NOT_AVAILABLE: {
+        readonly code: "FETCH_NOT_AVAILABLE";
+        readonly message: "Global fetch is not available in this environment.";
+    };
+    readonly FETCH_FAILED_AFTER_RETRIES: {
+        readonly code: "FETCH_FAILED_AFTER_RETRIES";
+        readonly message: (attempts: number, errorMessage: string) => string;
+    };
+    readonly FETCH_HTTP_ERROR: {
+        readonly code: "FETCH_HTTP_ERROR";
+        readonly message: (status: number, statusText: string) => string;
+    };
+};
+export declare const TOOL_METADATA_ERRORS: {
+    readonly INVALID_FORMAT: {
+        readonly code: "TOOL_METADATA_INVALID_FORMAT";
+        readonly message: "Invalid tool metadata format from remote source.";
+    };
+    readonly INVALID_API_RESPONSE: {
+        readonly code: "TOOL_METADATA_INVALID_API_RESPONSE";
+        readonly message: "Invalid API response structure";
+    };
+};
+export declare const FILE_OPERATION_ERRORS: {
+    readonly PATH_IS_DIRECTORY: {
+        readonly code: "FILE_PATH_IS_DIRECTORY";
+        readonly message: (toolName: string) => string;
+    };
+    readonly FILE_TOO_LARGE: {
+        readonly code: "FILE_TOO_LARGE";
+        readonly message: (fileSizeKB: number, maxSizeKB: number, toolName: string) => string;
+    };
+    readonly FILE_EMPTY: {
+        readonly code: "FILE_EMPTY";
+        readonly message: "File is empty - no content to display";
+    };
+    readonly BINARY_FILE: {
+        readonly code: "FILE_BINARY";
+        readonly message: "Binary file detected. Cannot display as text - download directly from GitHub";
+    };
+    readonly DECODE_FAILED: {
+        readonly code: "FILE_DECODE_FAILED";
+        readonly message: "Failed to decode file. Encoding may not be supported (expected UTF-8)";
+    };
+    readonly UNSUPPORTED_TYPE: {
+        readonly code: "FILE_UNSUPPORTED_TYPE";
+        readonly message: (type: string) => string;
+    };
+};
+export declare const REPOSITORY_ERRORS: {
+    readonly NOT_FOUND: {
+        readonly code: "REPO_NOT_FOUND";
+        readonly message: (owner: string, repo: string, error: string) => string;
+    };
+    readonly PATH_NOT_FOUND: {
+        readonly code: "REPO_PATH_NOT_FOUND";
+        readonly message: (path: string, owner: string, repo: string, branch: string) => string;
+    };
+    readonly PATH_NOT_FOUND_ANY_BRANCH: {
+        readonly code: "REPO_PATH_NOT_FOUND_ANY_BRANCH";
+        readonly message: (path: string, owner: string, repo: string) => string;
+    };
+    readonly ACCESS_FAILED: {
+        readonly code: "REPO_ACCESS_FAILED";
+        readonly message: (owner: string, repo: string, error: string) => string;
+    };
+    readonly STRUCTURE_EXPLORATION_FAILED: {
+        readonly code: "REPO_STRUCTURE_EXPLORATION_FAILED";
+        readonly message: "Failed to explore repository structure";
+    };
+};
+export declare const SEARCH_ERRORS: {
+    readonly QUERY_EMPTY: {
+        readonly code: "SEARCH_QUERY_EMPTY";
+        readonly message: "Search query cannot be empty";
+    };
+    readonly NO_VALID_PARAMETERS: {
+        readonly code: "SEARCH_NO_VALID_PARAMETERS";
+        readonly message: "No valid search parameters provided";
+    };
+    readonly PR_REQUIRED_PARAMS: {
+        readonly code: "SEARCH_PR_REQUIRED_PARAMS";
+        readonly message: "Owner, repo, and prNumber are required parameters";
+    };
+    readonly PR_SINGLE_VALUES: {
+        readonly code: "SEARCH_PR_SINGLE_VALUES";
+        readonly message: "Owner and repo must be single values";
+    };
+    readonly PULL_REQUEST_SEARCH_FAILED: {
+        readonly code: "SEARCH_PR_SEARCH_FAILED";
+        readonly message: (error: string) => string;
+    };
+    readonly PULL_REQUEST_LIST_FAILED: {
+        readonly code: "SEARCH_PR_LIST_FAILED";
+        readonly message: (error: string) => string;
+    };
+    readonly PULL_REQUEST_FETCH_FAILED: {
+        readonly code: "SEARCH_PR_FETCH_FAILED";
+        readonly message: (prNumber: number, error: string) => string;
+    };
+};
+export declare const STARTUP_ERRORS: {
+    readonly NO_TOOLS_REGISTERED: {
+        readonly code: "STARTUP_NO_TOOLS_REGISTERED";
+        readonly message: "No tools were successfully registered";
+    };
+    readonly UNCAUGHT_EXCEPTION: {
+        readonly code: "STARTUP_UNCAUGHT_EXCEPTION";
+        readonly message: (error: string) => string;
+    };
+    readonly UNHANDLED_REJECTION: {
+        readonly code: "STARTUP_UNHANDLED_REJECTION";
+        readonly message: (reason: string) => string;
+    };
+    readonly STARTUP_FAILED: {
+        readonly code: "STARTUP_FAILED";
+        readonly message: (error: string) => string;
+    };
+};
+export declare const PROMISE_ERRORS: {
+    readonly TIMEOUT: {
+        readonly code: "PROMISE_TIMEOUT";
+        readonly message: (index: number, timeout: number) => string;
+    };
+    readonly NOT_A_FUNCTION: {
+        readonly code: "PROMISE_NOT_A_FUNCTION";
+        readonly message: (index: number) => string;
+    };
+    readonly FUNCTION_UNDEFINED: {
+        readonly code: "PROMISE_FUNCTION_UNDEFINED";
+        readonly message: "Promise function is undefined";
+    };
+};
+export declare const TOOL_ERRORS: {
+    readonly EXECUTION_FAILED: {
+        readonly code: "TOOL_EXECUTION_FAILED";
+        readonly message: (toolName: string, error: string) => string;
+    };
+    readonly SECURITY_VALIDATION_FAILED: {
+        readonly code: "TOOL_SECURITY_VALIDATION_FAILED";
+        readonly message: (toolName: string, error: string) => string;
+    };
+};
+export declare const ALL_ERROR_CODES: {
+    readonly EXECUTION_FAILED: {
+        readonly code: "TOOL_EXECUTION_FAILED";
+        readonly message: (toolName: string, error: string) => string;
+    };
+    readonly SECURITY_VALIDATION_FAILED: {
+        readonly code: "TOOL_SECURITY_VALIDATION_FAILED";
+        readonly message: (toolName: string, error: string) => string;
+    };
+    readonly TIMEOUT: {
+        readonly code: "PROMISE_TIMEOUT";
+        readonly message: (index: number, timeout: number) => string;
+    };
+    readonly NOT_A_FUNCTION: {
+        readonly code: "PROMISE_NOT_A_FUNCTION";
+        readonly message: (index: number) => string;
+    };
+    readonly FUNCTION_UNDEFINED: {
+        readonly code: "PROMISE_FUNCTION_UNDEFINED";
+        readonly message: "Promise function is undefined";
+    };
+    readonly NO_TOOLS_REGISTERED: {
+        readonly code: "STARTUP_NO_TOOLS_REGISTERED";
+        readonly message: "No tools were successfully registered";
+    };
+    readonly UNCAUGHT_EXCEPTION: {
+        readonly code: "STARTUP_UNCAUGHT_EXCEPTION";
+        readonly message: (error: string) => string;
+    };
+    readonly UNHANDLED_REJECTION: {
+        readonly code: "STARTUP_UNHANDLED_REJECTION";
+        readonly message: (reason: string) => string;
+    };
+    readonly STARTUP_FAILED: {
+        readonly code: "STARTUP_FAILED";
+        readonly message: (error: string) => string;
+    };
+    readonly QUERY_EMPTY: {
+        readonly code: "SEARCH_QUERY_EMPTY";
+        readonly message: "Search query cannot be empty";
+    };
+    readonly NO_VALID_PARAMETERS: {
+        readonly code: "SEARCH_NO_VALID_PARAMETERS";
+        readonly message: "No valid search parameters provided";
+    };
+    readonly PR_REQUIRED_PARAMS: {
+        readonly code: "SEARCH_PR_REQUIRED_PARAMS";
+        readonly message: "Owner, repo, and prNumber are required parameters";
+    };
+    readonly PR_SINGLE_VALUES: {
+        readonly code: "SEARCH_PR_SINGLE_VALUES";
+        readonly message: "Owner and repo must be single values";
+    };
+    readonly PULL_REQUEST_SEARCH_FAILED: {
+        readonly code: "SEARCH_PR_SEARCH_FAILED";
+        readonly message: (error: string) => string;
+    };
+    readonly PULL_REQUEST_LIST_FAILED: {
+        readonly code: "SEARCH_PR_LIST_FAILED";
+        readonly message: (error: string) => string;
+    };
+    readonly PULL_REQUEST_FETCH_FAILED: {
+        readonly code: "SEARCH_PR_FETCH_FAILED";
+        readonly message: (prNumber: number, error: string) => string;
+    };
+    readonly NOT_FOUND: {
+        readonly code: "REPO_NOT_FOUND";
+        readonly message: (owner: string, repo: string, error: string) => string;
+    };
+    readonly PATH_NOT_FOUND: {
+        readonly code: "REPO_PATH_NOT_FOUND";
+        readonly message: (path: string, owner: string, repo: string, branch: string) => string;
+    };
+    readonly PATH_NOT_FOUND_ANY_BRANCH: {
+        readonly code: "REPO_PATH_NOT_FOUND_ANY_BRANCH";
+        readonly message: (path: string, owner: string, repo: string) => string;
+    };
+    readonly ACCESS_FAILED: {
+        readonly code: "REPO_ACCESS_FAILED";
+        readonly message: (owner: string, repo: string, error: string) => string;
+    };
+    readonly STRUCTURE_EXPLORATION_FAILED: {
+        readonly code: "REPO_STRUCTURE_EXPLORATION_FAILED";
+        readonly message: "Failed to explore repository structure";
+    };
+    readonly PATH_IS_DIRECTORY: {
+        readonly code: "FILE_PATH_IS_DIRECTORY";
+        readonly message: (toolName: string) => string;
+    };
+    readonly FILE_TOO_LARGE: {
+        readonly code: "FILE_TOO_LARGE";
+        readonly message: (fileSizeKB: number, maxSizeKB: number, toolName: string) => string;
+    };
+    readonly FILE_EMPTY: {
+        readonly code: "FILE_EMPTY";
+        readonly message: "File is empty - no content to display";
+    };
+    readonly BINARY_FILE: {
+        readonly code: "FILE_BINARY";
+        readonly message: "Binary file detected. Cannot display as text - download directly from GitHub";
+    };
+    readonly DECODE_FAILED: {
+        readonly code: "FILE_DECODE_FAILED";
+        readonly message: "Failed to decode file. Encoding may not be supported (expected UTF-8)";
+    };
+    readonly UNSUPPORTED_TYPE: {
+        readonly code: "FILE_UNSUPPORTED_TYPE";
+        readonly message: (type: string) => string;
+    };
+    readonly INVALID_FORMAT: {
+        readonly code: "TOOL_METADATA_INVALID_FORMAT";
+        readonly message: "Invalid tool metadata format from remote source.";
+    };
+    readonly INVALID_API_RESPONSE: {
+        readonly code: "TOOL_METADATA_INVALID_API_RESPONSE";
+        readonly message: "Invalid API response structure";
+    };
+    readonly FETCH_NOT_AVAILABLE: {
+        readonly code: "FETCH_NOT_AVAILABLE";
+        readonly message: "Global fetch is not available in this environment.";
+    };
+    readonly FETCH_FAILED_AFTER_RETRIES: {
+        readonly code: "FETCH_FAILED_AFTER_RETRIES";
+        readonly message: (attempts: number, errorMessage: string) => string;
+    };
+    readonly FETCH_HTTP_ERROR: {
+        readonly code: "FETCH_HTTP_ERROR";
+        readonly message: (status: number, statusText: string) => string;
+    };
+    readonly PROMISES_NOT_ARRAY: {
+        readonly code: "VALIDATION_PROMISES_NOT_ARRAY";
+        readonly message: "promises must be an array";
+    };
+    readonly TIMEOUT_NOT_POSITIVE: {
+        readonly code: "VALIDATION_TIMEOUT_NOT_POSITIVE";
+        readonly message: "timeout must be positive";
+    };
+    readonly CONCURRENCY_NOT_POSITIVE: {
+        readonly code: "VALIDATION_CONCURRENCY_NOT_POSITIVE";
+        readonly message: "concurrency must be positive";
+    };
+    readonly NOT_INITIALIZED: {
+        readonly code: "CONFIG_NOT_INITIALIZED";
+        readonly message: "Configuration not initialized. Call initialize() and await its completion before calling getServerConfig().";
+    };
+};

package/dist/errors/errorFactories.d.ts

@@ -0,0 +1,12 @@
+import { ToolError } from './ToolError.js';
+export declare const ToolErrors: {
+    pathValidationFailed: (filePath: string, reason?: string, workspaceRoot?: string) => ToolError;
+    fileAccessFailed: (filePath: string, cause?: Error, workspaceRoot?: string) => ToolError;
+    fileReadFailed: (filePath: string, cause?: Error, workspaceRoot?: string) => ToolError;
+    fileTooLarge: (filePath: string, sizeKB: number, limitKB: number) => ToolError;
+    binaryFileUnsupported: (filePath: string) => ToolError;
+    outputTooLarge: (size: number, limit: number) => ToolError;
+    commandNotAvailable: (command: string, installHint?: string) => ToolError;
+    commandExecutionFailed: (command: string, cause?: Error, stderr?: string) => ToolError;
+    toolExecutionFailed: (toolName: string, cause?: Error) => ToolError;
+};

package/dist/errors/localToolErrors.d.ts

@@ -0,0 +1,29 @@
+export declare const LOCAL_TOOL_ERROR_CODES: {
+    readonly PATH_VALIDATION_FAILED: "pathValidationFailed";
+    readonly FILE_ACCESS_FAILED: "fileAccessFailed";
+    readonly FILE_READ_FAILED: "fileReadFailed";
+    readonly FILE_TOO_LARGE: "fileTooLarge";
+    readonly BINARY_FILE_UNSUPPORTED: "binaryFileUnsupported";
+    readonly NO_MATCHES: "noMatches";
+    readonly OUTPUT_TOO_LARGE: "outputTooLarge";
+    readonly COMMAND_NOT_AVAILABLE: "commandNotAvailable";
+    readonly COMMAND_EXECUTION_FAILED: "commandExecutionFailed";
+    readonly COMMAND_TIMEOUT: "commandTimeout";
+    readonly TOOL_EXECUTION_FAILED: "toolExecutionFailed";
+};
+export type LocalToolErrorCode = (typeof LOCAL_TOOL_ERROR_CODES)[keyof typeof LOCAL_TOOL_ERROR_CODES];
+export declare enum LocalToolErrorCategory {
+    FILE_SYSTEM = "FILE_SYSTEM",
+    VALIDATION = "VALIDATION",
+    SEARCH = "SEARCH",
+    PAGINATION = "PAGINATION",
+    EXECUTION = "EXECUTION"
+}
+interface LocalToolErrorMetadata {
+    code: LocalToolErrorCode;
+    category: LocalToolErrorCategory;
+    description: string;
+    recoverability: 'recoverable' | 'unrecoverable' | 'user-action-required';
+}
+export declare const LOCAL_TOOL_ERROR_REGISTRY: Record<LocalToolErrorCode, LocalToolErrorMetadata>;
+export {};

package/dist/errors/pathUtils.d.ts

@@ -0,0 +1 @@
+export { redactPath } from 'octocode-security/pathUtils';

package/dist/github/client.d.ts

@@ -0,0 +1,12 @@
+import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+export declare const OctokitWithThrottling: typeof import("@octokit/core").Octokit & import("@octokit/core/types").Constructor<{
+    paginate: import("@octokit/plugin-paginate-rest").PaginateInterface;
+} & import("@octokit/plugin-paginate-graphql").paginateGraphQLInterface & import("@octokit/plugin-rest-endpoint-methods").Api & {
+    retry: {
+        retryRequest: (error: import("octokit").RequestError, retries: number, retryAfter: number) => import("octokit").RequestError;
+    };
+}> & import("@octokit/core/types").Constructor<{}>;
+export declare function getOctokit(authInfo?: AuthInfo): Promise<InstanceType<typeof OctokitWithThrottling>>;
+export declare const MAX_BRANCH_CACHE_SIZE = 200;
+export declare function resolveDefaultBranch(owner: string, repo: string, authInfo?: AuthInfo): Promise<string>;
+export declare function clearOctokitInstances(): void;

package/dist/github/codeSearch.d.ts

@@ -0,0 +1,8 @@
+import type { GitHubAPIResponse, OptimizedCodeSearchResult } from './githubAPI.js';
+import type { z } from 'zod';
+import type { GitHubCodeSearchQuerySchema } from '@octocodeai/octocode-core/schemas';
+type GitHubCodeSearchQuery = z.infer<typeof GitHubCodeSearchQuerySchema>;
+import type { WithOptionalMeta } from '../types/execution.js';
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
+export declare function searchGitHubCodeAPI(params: WithOptionalMeta<GitHubCodeSearchQuery>, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubAPIResponse<OptimizedCodeSearchResult>>;
+export {};

package/dist/github/directoryFetch.d.ts

@@ -0,0 +1,5 @@
+import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+import type { DirectoryFetchResult } from '../tools/github_fetch_content/types.js';
+export declare const MAX_DIRECTORY_FILES = 50;
+export declare const MAX_TOTAL_SIZE: number;
+export declare function fetchDirectoryContents(owner: string, repo: string, path: string, branch: string, authInfo?: AuthInfo, forceRefresh?: boolean): Promise<DirectoryFetchResult>;

package/dist/github/errorConstants.d.ts

@@ -0,0 +1,81 @@
+export declare const ERROR_CODES: {
+    readonly AUTH_REQUIRED: "AUTH_REQUIRED";
+    readonly RATE_LIMIT_PRIMARY: "RATE_LIMIT_PRIMARY";
+    readonly RATE_LIMIT_SECONDARY: "RATE_LIMIT_SECONDARY";
+    readonly FORBIDDEN_PERMISSIONS: "FORBIDDEN_PERMISSIONS";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly INVALID_REQUEST: "INVALID_REQUEST";
+    readonly SERVER_UNAVAILABLE: "SERVER_UNAVAILABLE";
+    readonly NETWORK_CONNECTION_FAILED: "NETWORK_CONNECTION_FAILED";
+    readonly REQUEST_TIMEOUT: "REQUEST_TIMEOUT";
+    readonly UNKNOWN: "UNKNOWN";
+};
+export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+export declare const ERROR_MESSAGES: {
+    readonly AUTH_REQUIRED: {
+        readonly message: "GitHub authentication required";
+        readonly suggestion: "TELL THE USER: Refresh your GitHub token! Run 'gh auth login' OR 'gh auth refresh' OR set a new GITHUB_TOKEN/GH_TOKEN environment variable";
+        readonly explanation: "API request requires authentication. GitHub APIs have different rate limits for authenticated (5000/hour) vs unauthenticated (60/hour) requests.";
+    };
+    readonly RATE_LIMIT_PRIMARY: {
+        readonly message: "GitHub API rate limit exceeded";
+        readonly messageWithTime: (resetTime: Date, seconds: number) => string;
+        readonly messageWithoutTime: "GitHub API rate limit exceeded. Reset time unavailable - check GitHub status or try again later";
+        readonly suggestion: "Set GITHUB_TOKEN for higher rate limits (5000/hour vs 60/hour)";
+        readonly explanation: "Primary rate limit tracks total API calls per hour. Authenticated users get 5000 requests/hour, unauthenticated get 60 requests/hour.";
+    };
+    readonly RATE_LIMIT_SECONDARY: {
+        readonly message: (retryAfter: number) => string;
+        readonly suggestion: "Reduce request frequency to avoid abuse detection";
+        readonly explanation: "Secondary rate limits prevent API abuse by limiting request frequency. Triggered by making too many requests too quickly, regardless of remaining quota.";
+        readonly fallbackRetryAfter: 60;
+    };
+    readonly FORBIDDEN_PERMISSIONS: {
+        readonly message: "Access forbidden - insufficient permissions";
+        readonly suggestion: "Check repository permissions or authentication";
+        readonly suggestionWithScopes: (missing: string[]) => string;
+        readonly fallbackSuggestion: "Token may not have sufficient permissions for this operation";
+        readonly explanation: "GitHub tokens require specific OAuth scopes for different operations. Common scopes: repo (full repository access), read:org (organization access), gist (gist access).";
+    };
+    readonly NOT_FOUND: {
+        readonly message: "Repository, resource, or path not found";
+        readonly explanation: "Resource not found or not accessible. Could be: incorrect path, deleted resource, private repository without access, wrong branch name.";
+    };
+    readonly INVALID_REQUEST: {
+        readonly message: "Invalid search query or request parameters";
+        readonly suggestion: "Check search syntax and parameter values";
+        readonly explanation: "Request was well-formed but contains invalid parameters. Common causes: invalid search syntax, parameters out of range, invalid filter combinations.";
+    };
+    readonly SERVER_UNAVAILABLE: {
+        readonly message: "GitHub API temporarily unavailable";
+        readonly suggestion: "Retry the request after a short delay";
+        readonly explanation: "GitHub servers are temporarily unavailable. Usually resolves quickly. Check https://www.githubstatus.com for service status.";
+    };
+    readonly NETWORK_CONNECTION_FAILED: {
+        readonly message: "Network connection failed";
+        readonly suggestion: "Check internet connection and GitHub API status";
+        readonly explanation: "Cannot establish connection to GitHub API. Check internet connectivity, DNS settings, and firewall/proxy configuration.";
+    };
+    readonly REQUEST_TIMEOUT: {
+        readonly message: "Request timeout";
+        readonly suggestion: "Retry the request or check network connectivity";
+        readonly explanation: "Request exceeded timeout limit. Could be slow network, large response size, or GitHub server delay.";
+    };
+    readonly UNKNOWN: {
+        readonly message: "Unknown error occurred";
+        readonly explanation: "An unexpected error occurred that does not match known error patterns.";
+    };
+};
+export declare const STATUS_TO_ERROR_CODE: Record<number, ErrorCode>;
+export declare const NETWORK_ERROR_PATTERNS: {
+    readonly CONNECTION_FAILED: readonly ["ENOTFOUND", "ECONNREFUSED"];
+    readonly TIMEOUT: readonly ["timeout"];
+};
+export declare const RATE_LIMIT_PATTERNS: {
+    readonly SECONDARY: RegExp;
+    readonly GRAPHQL_TYPE: "RATE_LIMITED";
+};
+export declare const RATE_LIMIT_CONFIG: {
+    readonly RESET_BUFFER_SECONDS: 1;
+    readonly SECONDARY_FALLBACK_SECONDS: 60;
+};

package/dist/github/errors.d.ts

@@ -0,0 +1,3 @@
+import type { GitHubAPIError } from './githubAPI.js';
+export declare function isNoResultsSearchError(error: unknown): boolean;
+export declare function handleGitHubAPIError(error: unknown): GitHubAPIError;

package/dist/github/fileContent.d.ts

@@ -0,0 +1,4 @@
+import type { GitHubAPIResponse } from './githubAPI.js';
+import type { FileContentExecutionQuery, GitHubFileContentApiResult } from '../tools/github_fetch_content/types.js';
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
+export declare function fetchGitHubFileContentAPI(params: FileContentExecutionQuery, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubAPIResponse<GitHubFileContentApiResult>>;

package/dist/github/fileContentProcess.d.ts

@@ -0,0 +1,11 @@
+import type { GitHubFileContentApiResult } from '../tools/github_fetch_content/types.js';
+import { OctokitWithThrottling } from './client.js';
+import type { MinifyMode } from '../scheme/fields.js';
+interface FileTimestampInfo {
+    lastModified: string;
+    lastModifiedBy: string;
+}
+export declare function applyContentPagination(data: GitHubFileContentApiResult, charOffset: number, charLength?: number): GitHubFileContentApiResult;
+export declare function fetchFileTimestamp(octokit: InstanceType<typeof OctokitWithThrottling>, owner: string, repo: string, path: string, branch?: string): Promise<FileTimestampInfo | null>;
+export declare function processFileContentAPI(decodedContent: string, owner: string, repo: string, branch: string, filePath: string, fullContent: boolean, startLine?: number, endLine?: number, contextLines?: number, matchString?: string, matchStringIsRegex?: boolean, matchStringCaseSensitive?: boolean, minify?: MinifyMode): Promise<GitHubFileContentApiResult>;
+export {};

package/dist/github/fileContentRaw.d.ts

@@ -0,0 +1,12 @@
+import type { GitHubAPIResponse } from './githubAPI.js';
+import type { z } from 'zod';
+import type { FileContentQuerySchema } from '@octocodeai/octocode-core/schemas';
+type FileContentQuery = z.infer<typeof FileContentQuerySchema>;
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
+export interface RawContentResult {
+    rawContent: string;
+    branch?: string;
+    resolvedRef: string;
+}
+export declare function fetchRawGitHubFileContent(params: FileContentQuery, authInfo?: AuthInfo): Promise<GitHubAPIResponse<RawContentResult>>;
+export {};