@octocodeai/octocode-tools-core 16.6.3 → 17.0.2

package/dist/github/botFilter.d.ts

@@ -0,0 +1 @@
+export declare function isBotAuthor(login: string): boolean;

package/dist/github/client.d.ts

@@ -1,4 +1,10 @@
 import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+export declare function hashGitHubToken(token: string): string;
+/**
+ * Auth segment for GitHub API cache keys. Distinct tokens (and Enterprise
+ * hosts) must not share cache entries. Never puts the raw token in the key.
+ */
+export declare function resolveCacheAuthFingerprint(authInfo?: AuthInfo): Promise<string>;
 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 & {

package/dist/github/directoryFetch/fetchDirectoryContents.d.ts

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

package/dist/github/directoryFetch/fetchFileContentToDisk.d.ts

@@ -0,0 +1,3 @@
+import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+import type { FileMaterializationResult } from '../../tools/github_fetch_content/types.js';
+export declare function fetchFileContentToDisk(owner: string, repo: string, path: string, branch: string, authInfo?: AuthInfo, forceRefresh?: boolean): Promise<FileMaterializationResult>;

package/dist/github/directoryFetch/helpers.d.ts

@@ -0,0 +1,35 @@
+import type { GitHubDirectoryFileEntry } from '@octocodeai/octocode-core/extra-types';
+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 const MAX_FILE_SIZE: number;
+export declare const CONCURRENCY = 5;
+export declare const FETCH_TIMEOUT_MS = 10000;
+export declare const BINARY_EXTENSIONS: Set<string>;
+export interface DirectoryEntry {
+    name: string;
+    path: string;
+    type: string;
+    size: number;
+    download_url: string | null;
+}
+export type DirectorySkipCounts = DirectoryFetchResult['skipped'];
+export declare const DIRECTORY_FETCH_LIMITS: {
+    maxDirectoryFiles: number;
+    maxTotalSize: number;
+    maxFileSize: number;
+};
+export declare function emptyDirectorySkipCounts(): DirectorySkipCounts;
+export declare function directoryFetchComplete(skipped: DirectorySkipCounts): boolean;
+export declare function directoryFetchWarnings(complete: boolean, verified: boolean): string[] | undefined;
+export declare function fetchFilesInBatches(entries: DirectoryEntry[], concurrency: number, token?: string): Promise<Array<{
+    entry: DirectoryEntry;
+    content: string;
+}>>;
+export declare function fetchDownloadUrl(url: string, token?: string): Promise<string>;
+export declare function scanDirectoryStats(dirPath: string, repoRoot: string): {
+    files: GitHubDirectoryFileEntry[];
+    fileCount: number;
+    totalSize: number;
+};
+export declare function safeFileSize(path: string): number;

package/dist/github/directoryFetch.d.ts

@@ -1,6 +1,3 @@
-import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
-import type { DirectoryFetchResult, FileMaterializationResult } 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>;
-export declare function fetchFileContentToDisk(owner: string, repo: string, path: string, branch: string, authInfo?: AuthInfo, forceRefresh?: boolean): Promise<FileMaterializationResult>;
+export { MAX_DIRECTORY_FILES, MAX_TOTAL_SIZE, } from './directoryFetch/helpers.js';
+export { fetchDirectoryContents } from './directoryFetch/fetchDirectoryContents.js';
+export { fetchFileContentToDisk } from './directoryFetch/fetchFileContentToDisk.js';

package/dist/github/fileContentPagination.d.ts

@@ -0,0 +1,9 @@
+import type { GitHubFileContentApiResult } from '../tools/github_fetch_content/types.js';
+import { OctokitWithThrottling } from './client.js';
+interface FileTimestampInfo {
+    lastModified: string;
+    lastModifiedBy: string;
+}
+export declare function applyContentPagination(data: GitHubFileContentApiResult, charOffset: number, charLength?: number): Promise<GitHubFileContentApiResult>;
+export declare function fetchFileTimestamp(octokit: InstanceType<typeof OctokitWithThrottling>, owner: string, repo: string, path: string, branch?: string): Promise<FileTimestampInfo | null>;
+export {};

package/dist/github/fileContentProcess.d.ts

@@ -1,11 +1,4 @@
 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 { applyContentPagination, fetchFileTimestamp, } from './fileContentPagination.js';
 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/fetch.d.ts

@@ -0,0 +1,20 @@
+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 type RawContentFetchOptions = {
+    /** Prior ETag for conditional GET (If-None-Match). */
+    ifNoneMatch?: string;
+};
+export type RawContentFetchResponse = GitHubAPIResponse<RawContentResult> & {
+    etag?: string;
+    notModified?: boolean;
+};
+export declare function fetchRawGitHubFileContent(params: FileContentQuery, authInfo?: AuthInfo, opts?: RawContentFetchOptions): Promise<RawContentFetchResponse>;
+export {};

package/dist/github/fileContentRaw/pathSuggestions.d.ts

@@ -0,0 +1,3 @@
+import type { OctokitWithThrottling } from '../client.js';
+export declare function buildPathSuggestionHints(requestedPath: string, suggestions: string[]): string[];
+export declare function findPathSuggestions(octokit: InstanceType<typeof OctokitWithThrottling>, owner: string, repo: string, filePath: string, branch: string): Promise<string[]>;

package/dist/github/fileContentRaw.d.ts

@@ -1,12 +1,2 @@
-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 {};
+export type { RawContentResult, RawContentFetchOptions, RawContentFetchResponse, } from './fileContentRaw/fetch.js';
+export { fetchRawGitHubFileContent } from './fileContentRaw/fetch.js';

package/dist/github/githubAPI.d.ts

@@ -52,7 +52,10 @@ export interface HistoryCommitFile {
 export interface HistoryCommit {
     sha: string;
     date: string;
-    message: string;
+    /** Headline + (truncated) body; omitted when identical to messageHeadline. */
+    message?: string;
+    /** Present when the message body was cut at 500 chars — the '…' is a real cut. */
+    messageTruncated?: true;
     messageHeadline: string;
     url: string;
     author: {

package/dist/github/history.d.ts

@@ -1,6 +1,8 @@
 import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
 import type { GitHubAPIResponse, HistoryResult } from './githubAPI.js';
-export declare function fetchHistory(params: {
+/** GitHub REST pagination: a `rel="next"` Link header means more pages exist. */
+export declare function parseHasMore(linkHeader: string | undefined): boolean;
+type FetchHistoryParams = {
     type: 'file' | 'repo';
     owner: string;
     repo: string;
@@ -16,4 +18,6 @@ export declare function fetchHistory(params: {
     includeDiff: boolean;
     charOffset?: number;
     charLength?: number;
-}, authInfo?: AuthInfo): Promise<GitHubAPIResponse<HistoryResult>>;
+};
+export declare function fetchHistory(params: FetchHistoryParams, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubAPIResponse<HistoryResult>>;
+export {};

package/dist/github/issues/fetchers.d.ts

@@ -0,0 +1,7 @@
+import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+import type { GitHubAPIResponse } from '../githubAPI.js';
+import { type IssueSearchParams } from '../queryBuilders.js';
+import type { FetchIssuesParams, IssuesResult } from './types.js';
+export declare function fetchIssueByNumber(params: FetchIssuesParams, authInfo?: AuthInfo): Promise<GitHubAPIResponse<IssuesResult>>;
+export declare function searchIssues(searchParams: IssueSearchParams, params: FetchIssuesParams, authInfo?: AuthInfo): Promise<GitHubAPIResponse<IssuesResult>>;
+export declare function listIssues(params: FetchIssuesParams, authInfo?: AuthInfo): Promise<GitHubAPIResponse<IssuesResult>>;

package/dist/github/issues/helpers.d.ts

@@ -0,0 +1,32 @@
+import type { GitHubAPIError } from '../githubAPI.js';
+import type { FetchIssuesParams, IssueRow } from './types.js';
+export declare function firstString(value: string | string[] | undefined): string | undefined;
+export declare function combineQuery(params: FetchIssuesParams): string | undefined;
+export declare function windowText(text: string, charOffset: number | undefined, charLength: number | undefined): {
+    text: string;
+    pagination?: NonNullable<IssueRow['contentPagination']>['body'];
+};
+export declare function hasPullRequestField(item: {
+    pull_request?: unknown;
+}): boolean;
+export declare function mapIssueLabels(labels: Array<string | {
+    name?: string | null;
+}> | undefined): string[];
+export declare function toIssueRow(item: {
+    number: number;
+    title?: string | null;
+    state?: string | null;
+    user?: {
+        login?: string | null;
+    } | null;
+    labels?: Array<string | {
+        name?: string | null;
+    }>;
+    created_at?: string | null;
+    updated_at?: string | null;
+    closed_at?: string | null;
+    html_url?: string | null;
+    body?: string | null;
+}): IssueRow;
+export declare function createIssueError(message: string, hints?: string[]): GitHubAPIError;
+export declare function buildIssueSearchCacheKey(params: FetchIssuesParams, sessionId?: string, authFingerprint?: string): string;

package/dist/github/issues/orchestrator.d.ts

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

package/dist/github/issues/types.d.ts

@@ -0,0 +1,72 @@
+import type { IssueSearchParams } from '../queryBuilders.js';
+export type IssueCommentRow = {
+    id: string;
+    user: string;
+    body: string;
+    created_at: string;
+    updated_at: string;
+    commentType: 'discussion';
+};
+export type IssueRow = {
+    number: number;
+    title: string;
+    state: string;
+    author: string;
+    labels: string[];
+    created_at: string;
+    updated_at: string;
+    closed_at?: string;
+    url: string;
+    body?: string;
+    comments?: IssueCommentRow[];
+    contentPagination?: {
+        body?: {
+            charOffset: number;
+            charLength: number;
+            totalChars: number;
+            hasMore: boolean;
+            nextCharOffset?: number;
+        };
+        comments?: {
+            currentPage: number;
+            itemsPerPage: number;
+            totalComments: number;
+            hasMore: boolean;
+            nextCommentPage?: number;
+        };
+    };
+};
+export type IssuesResult = {
+    type: 'issues';
+    owner: string;
+    repo: string;
+    issues: IssueRow[] | string[];
+    total_count?: number;
+    effectiveQuery?: string;
+    incomplete_results?: boolean;
+    pagination?: {
+        currentPage: number;
+        perPage: number;
+        hasMore: boolean;
+        nextPage?: number;
+        totalMatches?: number;
+        reportedTotalMatches?: number;
+        totalMatchesKind?: 'reported';
+    };
+};
+export type FetchIssuesParams = IssueSearchParams & {
+    issueNumber?: number;
+    keywordsToSearch?: string[];
+    concise?: boolean;
+    content?: {
+        body?: boolean;
+        comments?: {
+            discussion?: boolean;
+            includeBots?: boolean;
+        };
+    };
+    charOffset?: number;
+    charLength?: number;
+    commentPage?: number;
+    itemsPerPage?: number;
+};

package/dist/github/issues.d.ts

@@ -0,0 +1,3 @@
+export type { IssueCommentRow, IssueRow, IssuesResult, FetchIssuesParams, } from './issues/types.js';
+export { buildIssueSearchCacheKey } from './issues/helpers.js';
+export { fetchIssues } from './issues/orchestrator.js';

package/dist/github/prContentFetcher/comments.d.ts

@@ -0,0 +1,11 @@
+import { PRCommentItem, PRReviewInfo } from '../githubAPI.js';
+import { OctokitWithThrottling } from '../client.js';
+export declare function fetchPRComments(octokit: InstanceType<typeof OctokitWithThrottling>, owner: string, repo: string, prNumber: number, includeBots?: boolean): Promise<{
+    comments: PRCommentItem[];
+    note?: string;
+}>;
+export declare function fetchPRReviews(octokit: InstanceType<typeof OctokitWithThrottling>, owner: string, repo: string, prNumber: number): Promise<PRReviewInfo[]>;
+export declare function fetchPRInlineComments(octokit: InstanceType<typeof OctokitWithThrottling>, owner: string, repo: string, prNumber: number, includeBots?: boolean): Promise<{
+    comments: PRCommentItem[];
+    note?: string;
+}>;

package/dist/github/prContentFetcher/commits.d.ts

@@ -0,0 +1,27 @@
+import { GitHubPullRequestsSearchParams, CommitInfo, DiffEntry, CommitFileInfo } from '../githubAPI.js';
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
+export declare function fetchAllPaginated<T>(fetchPage: (page: number) => Promise<{
+    data: T[];
+}>): Promise<{
+    items: T[];
+    rawResponseChars: number;
+}>;
+export declare function fetchPRFileChangesAPI(owner: string, repo: string, prNumber: number, authInfo?: AuthInfo): Promise<{
+    total_count: number;
+    files: DiffEntry[];
+} | null>;
+interface CommitListItem {
+    sha: string;
+    commit: {
+        message: string;
+        author: {
+            name: string;
+            date: string;
+        } | null;
+    };
+}
+export declare function fetchPRCommitsAPI(owner: string, repo: string, prNumber: number, authInfo?: AuthInfo): Promise<CommitListItem[] | null>;
+export declare function fetchCommitFilesAPI(owner: string, repo: string, sha: string, authInfo?: AuthInfo): Promise<CommitFileInfo[] | null>;
+export declare function mapPool<T, R>(items: T[], concurrency: number, mapper: (item: T, index: number) => Promise<R>): Promise<R[]>;
+export declare function fetchPRCommitsWithFiles(owner: string, repo: string, prNumber: number, params: GitHubPullRequestsSearchParams, authInfo?: AuthInfo): Promise<CommitInfo[] | null>;
+export {};

package/dist/github/prContentFetcher/flags.d.ts

@@ -0,0 +1,21 @@
+import { GitHubPullRequestsSearchParams } from '../githubAPI.js';
+export declare function shouldFetchFileChanges(params: GitHubPullRequestsSearchParams): boolean;
+export type ContentComments = {
+    discussion?: boolean;
+    reviewInline?: boolean;
+    includeBots?: boolean;
+    file?: string;
+};
+export declare function getCommentsConfig(params: GitHubPullRequestsSearchParams): ContentComments | null;
+export declare function shouldFetchDiscussionComments(params: GitHubPullRequestsSearchParams): boolean;
+export declare function shouldFetchInlineComments(params: GitHubPullRequestsSearchParams): boolean;
+export declare function shouldFetchCommits(params: GitHubPullRequestsSearchParams): boolean;
+export declare function shouldFetchReviews(params: GitHubPullRequestsSearchParams): boolean;
+/**
+ * Whether search hits need a per-PR `pulls.get` enrichment call.
+ * Lean list searches skip it (~1 REST call per hit); detail/content/review
+ * modes still enrich.
+ */
+export declare function shouldEnrichPullRequestFromSearch(params: GitHubPullRequestsSearchParams): boolean;
+export declare function shouldIncludeBotComments(params: GitHubPullRequestsSearchParams): boolean;
+export declare function stripMachineBlobs(body: string): string;

package/dist/github/prContentFetcher/transform.d.ts

@@ -0,0 +1,5 @@
+import { GitHubPullRequestsSearchParams, GitHubPullRequestItem, IssueSearchResultItem, PullRequestSimple, PullRequestItem } from '../githubAPI.js';
+import { OctokitWithThrottling } from '../client.js';
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
+export declare function transformPullRequestItemFromSearch(item: IssueSearchResultItem, params: GitHubPullRequestsSearchParams, octokit: InstanceType<typeof OctokitWithThrottling>): Promise<GitHubPullRequestItem>;
+export declare function transformPullRequestItemFromREST(item: PullRequestSimple | PullRequestItem, params: GitHubPullRequestsSearchParams, octokit: InstanceType<typeof OctokitWithThrottling>, authInfo?: AuthInfo): Promise<GitHubPullRequestItem>;

package/dist/github/prContentFetcher.d.ts

@@ -1,5 +1,2 @@
-import { GitHubPullRequestsSearchParams, GitHubPullRequestItem, IssueSearchResultItem, PullRequestSimple, PullRequestItem } from './githubAPI.js';
-import { OctokitWithThrottling } from './client.js';
-import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
-export declare function transformPullRequestItemFromSearch(item: IssueSearchResultItem, params: GitHubPullRequestsSearchParams, octokit: InstanceType<typeof OctokitWithThrottling>): Promise<GitHubPullRequestItem>;
-export declare function transformPullRequestItemFromREST(item: PullRequestSimple | PullRequestItem, params: GitHubPullRequestsSearchParams, octokit: InstanceType<typeof OctokitWithThrottling>, authInfo?: AuthInfo): Promise<GitHubPullRequestItem>;
+export { shouldEnrichPullRequestFromSearch } from './prContentFetcher/flags.js';
+export { transformPullRequestItemFromSearch, transformPullRequestItemFromREST, } from './prContentFetcher/transform.js';

package/dist/github/pullRequestSearch/restSearch.d.ts

@@ -0,0 +1,6 @@
+import type { GitHubAPIError, GitHubPullRequestsSearchParams } from '../githubAPI.js';
+import type { GitHubPullRequestSearchApiResult } from '../../tools/github_search_pull_requests/types.js';
+import { OctokitWithThrottling } from '../client.js';
+export declare function createPullRequestErrorResult(apiError: GitHubAPIError, error: string, hints: string[]): GitHubPullRequestSearchApiResult;
+export declare function createPullRequestEmptyResult(params: GitHubPullRequestsSearchParams): GitHubPullRequestSearchApiResult;
+export declare function searchPullRequestsWithREST(octokit: InstanceType<typeof OctokitWithThrottling>, params: GitHubPullRequestsSearchParams): Promise<GitHubPullRequestSearchApiResult>;

package/dist/github/pullRequestSearch.d.ts

@@ -1,5 +1,5 @@
 import type { GitHubPullRequestsSearchParams } from './githubAPI.js';
 import type { GitHubPullRequestSearchApiResult } from '../tools/github_search_pull_requests/types.js';
 import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
-export declare function buildPullRequestSearchCacheKey(params: GitHubPullRequestsSearchParams, sessionId?: string): string;
+export declare function buildPullRequestSearchCacheKey(params: GitHubPullRequestsSearchParams, sessionId?: string, authFingerprint?: string): string;
 export declare function searchGitHubPullRequestsAPI(params: GitHubPullRequestsSearchParams, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubPullRequestSearchApiResult>;

package/dist/github/queryBuilders/base.d.ts

@@ -0,0 +1,25 @@
+import type { GitHubPullRequestsSearchParams } from '../githubAPI.js';
+export declare function getOwnerQualifier(owner: string): string;
+export declare function quoteKeywordIfNeeded(keyword: string): string;
+export declare abstract class BaseQueryBuilder {
+    protected queryParts: string[];
+    addOwnerRepo(params: {
+        owner?: string | string[] | null;
+        repo?: string | string[] | null;
+    }): this;
+    addDateFilters(params: Record<string, unknown> | GitHubPullRequestsSearchParams): this;
+    addArrayFilter(values: string | string[] | null | undefined, prefix: string, quoted?: boolean): this;
+    addBooleanFilter(value: boolean | undefined, trueQuery: string, falseQuery: string): this;
+    addSimpleFilter(value: string | number | null | undefined, key: string): this;
+    addQuotedFilter(value: string | null | undefined, key: string): this;
+    addEngagementFilters(params: {
+        comments?: number | string;
+        reactions?: number | string;
+        interactions?: number | string;
+    }): this;
+    addOrganizationFilters(params: {
+        label?: string | string[];
+        milestone?: string;
+    }): this;
+    build(): string;
+}

package/dist/github/queryBuilders/codeAndRepo.d.ts

@@ -0,0 +1,20 @@
+import type { z } from 'zod';
+import type { GitHubCodeSearchQuerySchema, GitHubReposSearchSingleQuerySchema } from '@octocodeai/octocode-core/schemas';
+type GitHubCodeSearchQuery = z.infer<typeof GitHubCodeSearchQuerySchema>;
+type GitHubReposSearchSingleQuery = z.infer<typeof GitHubReposSearchSingleQuerySchema>;
+import type { WithOptionalMeta } from '../../types/execution.js';
+import { BaseQueryBuilder } from './base.js';
+export declare class CodeSearchQueryBuilder extends BaseQueryBuilder {
+    addQueryTerms(params: WithOptionalMeta<GitHubCodeSearchQuery>): this;
+    addSearchFilters(params: WithOptionalMeta<GitHubCodeSearchQuery>): this;
+    addMatchFilters(params: WithOptionalMeta<GitHubCodeSearchQuery>): this;
+}
+export declare class RepoSearchQueryBuilder extends BaseQueryBuilder {
+    addQueryTerms(params: WithOptionalMeta<GitHubReposSearchSingleQuery>): this;
+    addRepoFilters(params: WithOptionalMeta<GitHubReposSearchSingleQuery>): this;
+    addMatchFilters(params: WithOptionalMeta<GitHubReposSearchSingleQuery>): this;
+    addQualityFilters(params?: WithOptionalMeta<GitHubReposSearchSingleQuery>): this;
+}
+export declare function buildCodeSearchQuery(params: WithOptionalMeta<GitHubCodeSearchQuery>): string;
+export declare function buildRepoSearchQuery(params: WithOptionalMeta<GitHubReposSearchSingleQuery>): string;
+export {};

package/dist/github/queryBuilders/issues.d.ts

@@ -0,0 +1,42 @@
+import { BaseQueryBuilder } from './base.js';
+/** Issue-search params — PR-only fields (draft/review/head/base) are omitted. */
+export type IssueSearchParams = {
+    query?: string;
+    owner?: string | string[];
+    repo?: string | string[];
+    state?: 'open' | 'closed' | 'merged';
+    author?: string;
+    assignee?: string;
+    mentions?: string;
+    commenter?: string;
+    involves?: string;
+    created?: string;
+    updated?: string;
+    closed?: string;
+    comments?: number | string;
+    reactions?: number | string;
+    interactions?: number | string;
+    label?: string | string[];
+    milestone?: string;
+    locked?: boolean;
+    visibility?: 'public' | 'private';
+    'no-assignee'?: boolean;
+    'no-label'?: boolean;
+    'no-milestone'?: boolean;
+    'no-project'?: boolean;
+    match?: ('title' | 'body' | 'comments')[];
+    archived?: boolean;
+    sort?: 'created' | 'updated' | 'best-match' | 'comments' | 'reactions';
+    order?: 'asc' | 'desc';
+    limit?: number;
+    page?: number;
+};
+export declare class IssueSearchQueryBuilder extends BaseQueryBuilder {
+    addBasicFilters(params: IssueSearchParams): this;
+    addStateFilters(params: IssueSearchParams): this;
+    addUserFilters(params: IssueSearchParams): this;
+    addNegativeFilters(params: IssueSearchParams): this;
+    addMiscFilters(params: IssueSearchParams): this;
+}
+export declare function buildIssueSearchQuery(params: IssueSearchParams): string;
+export declare function shouldUseSearchForIssues(params: IssueSearchParams): boolean;

package/dist/github/queryBuilders/pullRequests.d.ts

@@ -0,0 +1,13 @@
+import { GitHubPullRequestsSearchParams } from '../githubAPI.js';
+import { BaseQueryBuilder } from './base.js';
+export declare class PullRequestSearchQueryBuilder extends BaseQueryBuilder {
+    addBasicFilters(params: GitHubPullRequestsSearchParams): this;
+    addStateFilters(params: GitHubPullRequestsSearchParams): this;
+    addUserFilters(params: GitHubPullRequestsSearchParams): this;
+    addBranchFilters(params: GitHubPullRequestsSearchParams): this;
+    addReviewFilters(params: GitHubPullRequestsSearchParams): this;
+    addNegativeFilters(params: GitHubPullRequestsSearchParams): this;
+    addMiscFilters(params: GitHubPullRequestsSearchParams): this;
+}
+export declare function buildPullRequestSearchQuery(params: GitHubPullRequestsSearchParams): string;
+export declare function shouldUseSearchForPRs(params: GitHubPullRequestsSearchParams): boolean;

package/dist/github/queryBuilders.d.ts

@@ -1,12 +1,4 @@
-import type { z } from 'zod';
-import type { GitHubCodeSearchQuerySchema, GitHubReposSearchSingleQuerySchema } from '@octocodeai/octocode-core/schemas';
-type GitHubCodeSearchQuery = z.infer<typeof GitHubCodeSearchQuerySchema>;
-type GitHubReposSearchSingleQuery = z.infer<typeof GitHubReposSearchSingleQuerySchema>;
-import type { WithOptionalMeta } from '../types/execution.js';
-import { GitHubPullRequestsSearchParams } from './githubAPI.js';
-export declare function getOwnerQualifier(owner: string): string;
-export declare function buildCodeSearchQuery(params: WithOptionalMeta<GitHubCodeSearchQuery>): string;
-export declare function buildRepoSearchQuery(params: WithOptionalMeta<GitHubReposSearchSingleQuery>): string;
-export declare function buildPullRequestSearchQuery(params: GitHubPullRequestsSearchParams): string;
-export declare function shouldUseSearchForPRs(params: GitHubPullRequestsSearchParams): boolean;
-export {};
+export { getOwnerQualifier } from './queryBuilders/base.js';
+export { buildCodeSearchQuery, buildRepoSearchQuery, } from './queryBuilders/codeAndRepo.js';
+export { buildPullRequestSearchQuery, shouldUseSearchForPRs, } from './queryBuilders/pullRequests.js';
+export { buildIssueSearchQuery, shouldUseSearchForIssues, type IssueSearchParams, } from './queryBuilders/issues.js';

package/dist/github/releases.d.ts

@@ -0,0 +1,37 @@
+import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+import type { GitHubAPIResponse } from './githubAPI.js';
+type ReleaseRow = {
+    tagName: string;
+    name?: string;
+    publishedAt?: string;
+    prerelease?: true;
+    draft?: true;
+    /** Marks the release GitHub reports as "latest" (stable, non-prerelease). */
+    latest?: true;
+    url?: string;
+};
+export type ReleasesResult = {
+    type: 'releases';
+    owner: string;
+    repo: string;
+    releases: ReleaseRow[];
+    /** The repo's latest stable release, surfaced even when it is not on this page. */
+    latest?: {
+        tagName: string;
+        publishedAt?: string;
+    };
+    pagination: {
+        currentPage: number;
+        perPage: number;
+        hasMore: boolean;
+        nextPage?: number;
+    };
+};
+type FetchReleasesParams = {
+    owner: string;
+    repo: string;
+    page: number;
+    perPage: number;
+};
+export declare function fetchReleases(params: FetchReleasesParams, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubAPIResponse<ReleasesResult>>;
+export {};

package/dist/github/repoStructure/contentResolution.d.ts

@@ -0,0 +1,12 @@
+import type { Octokit } from 'octokit';
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
+import type { GitHubApiFileItem, GitHubRepositoryStructureError } from '../../tools/github_view_repo_structure/types.js';
+export interface ContentResolution {
+    data: unknown;
+    workingBranch: string;
+    repoDefaultBranch?: string;
+    etag?: string;
+    notModified?: boolean;
+}
+export declare function resolveContentWithBranchFallback(octokit: Octokit, owner: string, repo: string, cleanPath: string, branch: string | undefined, authInfo?: AuthInfo, ifNoneMatch?: string): Promise<ContentResolution | GitHubRepositoryStructureError>;
+export declare function mapApiItems(items: unknown[]): GitHubApiFileItem[];

package/dist/github/repoStructure/fetchOrchestration.d.ts

@@ -0,0 +1,7 @@
+import type { z } from 'zod';
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
+import type { GitHubViewRepoStructureQuerySchema } from '@octocodeai/octocode-core/schemas';
+type GitHubViewRepoStructureQuery = z.infer<typeof GitHubViewRepoStructureQuerySchema>;
+import type { GitHubRepositoryStructureResult, GitHubRepositoryStructureError } from '../../tools/github_view_repo_structure/types.js';
+export declare function viewGitHubRepositoryStructureAPI(params: GitHubViewRepoStructureQuery, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubRepositoryStructureResult | GitHubRepositoryStructureError>;
+export {};

package/dist/github/repoStructure/resultBuilder.d.ts

@@ -0,0 +1,22 @@
+import type { GitHubApiFileItem, GitHubRepositoryStructureResult } from '../../tools/github_view_repo_structure/types.js';
+export declare function buildStructureTree(items: GitHubApiFileItem[], basePath: string): Record<string, {
+    files: string[];
+    folders: string[];
+}>;
+export declare function buildFileSizeMap(items: GitHubApiFileItem[], basePath: string): Record<string, Record<string, number>>;
+export declare function buildStructureResult(args: {
+    owner: string;
+    repo: string;
+    workingBranch: string;
+    repoDefaultBranch?: string;
+    cleanPath: string;
+    depth: number;
+    allItems: GitHubApiFileItem[];
+    partialTreeFailures: number;
+    incompleteTree: boolean;
+    rawResponseChars: number;
+    includeSizes: boolean;
+    itemsPerPage?: number;
+    page?: number;
+    extraHints?: string[];
+}): GitHubRepositoryStructureResult;

package/dist/github/repoStructure.d.ts

@@ -1,7 +1 @@
-import type { z } from 'zod';
-import type { GitHubViewRepoStructureQuerySchema } from '@octocodeai/octocode-core/schemas';
-type GitHubViewRepoStructureQuery = z.infer<typeof GitHubViewRepoStructureQuerySchema>;
-import type { GitHubRepositoryStructureResult, GitHubRepositoryStructureError } from '../tools/github_view_repo_structure/types.js';
-import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
-export declare function viewGitHubRepositoryStructureAPI(params: GitHubViewRepoStructureQuery, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubRepositoryStructureResult | GitHubRepositoryStructureError>;
-export {};
+export { viewGitHubRepositoryStructureAPI } from './repoStructure/fetchOrchestration.js';