@octocodeai/octocode-tools-core 16.6.3 → 17.0.2

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

@@ -39,7 +39,7 @@ export declare const GitHubCodeSearchOutputLocalSchema: z.ZodObject<{
     results: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         data: z.ZodObject<{
-            files: z.ZodArray<z.ZodObject<{
+            files: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
                 owner: z.ZodString;
                 repo: z.ZodString;
                 path: z.ZodString;
@@ -54,7 +54,7 @@ export declare const GitHubCodeSearchOutputLocalSchema: z.ZodObject<{
                     }, z.core.$strip>>>;
                     url: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>;
-            }, z.core.$strip>>;
+            }, z.core.$strip>]>>;
             pagination: z.ZodOptional<z.ZodObject<{
                 currentPage: z.ZodNumber;
                 totalPages: z.ZodNumber;
@@ -62,6 +62,14 @@ export declare const GitHubCodeSearchOutputLocalSchema: z.ZodObject<{
                 nextPage: z.ZodOptional<z.ZodNumber>;
                 pageSize: z.ZodOptional<z.ZodNumber>;
                 totalItems: z.ZodOptional<z.ZodNumber>;
+                perPage: z.ZodOptional<z.ZodNumber>;
+                totalFound: z.ZodOptional<z.ZodNumber>;
+                returned: z.ZodOptional<z.ZodNumber>;
+                totalMatches: z.ZodOptional<z.ZodNumber>;
+                reportedTotalMatches: z.ZodOptional<z.ZodNumber>;
+                reachableTotalMatches: z.ZodOptional<z.ZodNumber>;
+                totalResults: z.ZodOptional<z.ZodNumber>;
+                itemsPerPage: z.ZodOptional<z.ZodNumber>;
                 totalMatchesKind: z.ZodOptional<z.ZodEnum<{
                     exact: "exact";
                     reported: "reported";
@@ -78,6 +86,25 @@ export declare const GitHubCodeSearchOutputLocalSchema: z.ZodObject<{
         incompleteResults: z.ZodOptional<z.ZodLiteral<true>>;
     }, z.core.$strip>>>;
     warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    diagnostics: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        level: z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warning: "warning";
+        }>;
+        message: z.ZodString;
+        field: z.ZodOptional<z.ZodString>;
+        code: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    next: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        tool: z.ZodString;
+        query: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        why: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodOptional<z.ZodEnum<{
+            exact: "exact";
+            heuristic: "heuristic";
+        }>>;
+    }, z.core.$strip>>>;
     errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         error: z.ZodString;

package/dist/tools/github_search_pull_requests/contentResponse/commentsShaping.d.ts

@@ -0,0 +1,68 @@
+import type { NormalizedPrContentRequest } from '../contentRequest.js';
+import { type QueryLike } from './pagination.js';
+export declare function shapeComments(pr: Record<string, unknown>, query: QueryLike, request: NormalizedPrContentRequest): {
+    comments?: undefined;
+    commentPagination?: undefined;
+} | {
+    comments: ({
+        createdAt: unknown;
+        updatedAt: unknown;
+        body: string;
+        bodyPagination: {
+            nextCharOffset?: number;
+            charOffset: number;
+            charLength: number;
+            totalChars: number;
+            hasMore: boolean;
+        };
+        in_reply_to_id?: unknown;
+        id: unknown;
+        author: unknown;
+        commentType: unknown;
+        path: unknown;
+        line: unknown;
+    } | {
+        createdAt: unknown;
+        updatedAt: unknown;
+        bodyPreview: string;
+        in_reply_to_id?: unknown;
+        id: unknown;
+        author: unknown;
+        commentType: unknown;
+        path: unknown;
+        line: unknown;
+    })[];
+    commentPagination: import("./pagination.js").Pagination;
+};
+export declare function shapeReviews(pr: Record<string, unknown>, query: QueryLike, request: NormalizedPrContentRequest): {
+    reviews?: undefined;
+} | {
+    reviews: {
+        submittedAt: unknown;
+        commitId: unknown;
+        body?: string;
+        bodyPagination?: {
+            nextCharOffset?: number;
+            charOffset: number;
+            charLength: number;
+            totalChars: number;
+            hasMore: boolean;
+        };
+        id: unknown;
+        user: unknown;
+        state: unknown;
+    }[];
+};
+export declare function shapeCommits(pr: Record<string, unknown>, query: QueryLike, request: NormalizedPrContentRequest): {
+    commits?: undefined;
+    commitPagination?: undefined;
+} | {
+    commits: {
+        files?: any[];
+        sha: unknown;
+        message: unknown;
+        author: unknown;
+        date: unknown;
+    }[];
+    commitPagination: import("./pagination.js").Pagination;
+};

package/dist/tools/github_search_pull_requests/contentResponse/fileSurfaces.d.ts

@@ -0,0 +1,52 @@
+import type { NormalizedPrContentRequest } from '../contentRequest.js';
+import { type QueryLike } from './pagination.js';
+export declare function filePathOf(change: Record<string, unknown>): string;
+export declare function shapeFileChange(change: Record<string, unknown>, includePatch: boolean): {
+    patch?: string;
+    path: string;
+    status: string;
+    additions: number;
+    deletions: number;
+};
+export declare function stripPatchComments(patch: string): string;
+export declare function shapeFileSurfaces(pr: Record<string, unknown>, query: QueryLike, request: NormalizedPrContentRequest, shouldMinify?: boolean): {
+    changedFiles: ({
+        patch?: string;
+        path: string;
+        status: string;
+        additions: number;
+        deletions: number;
+    } | {
+        patchPagination?: {
+            nextCharOffset?: number;
+            charOffset: number;
+            charLength: number;
+            totalChars: number;
+            hasMore: boolean;
+        };
+        patch: string;
+        diff: import("../../../index.js").DiffPreview;
+        path: string;
+        status: string;
+        additions: number;
+        deletions: number;
+    })[];
+    filePagination: import("./pagination.js").Pagination;
+    filePathsPreview?: undefined;
+    filePathsPagination?: undefined;
+} | {
+    changedFiles?: undefined;
+    filePagination?: undefined;
+    filePathsPreview?: undefined;
+    filePathsPagination?: undefined;
+} | {
+    filePathsPreview: string[];
+    filePathsPagination: {
+        nextFilePage?: number;
+        totalFiles: number;
+        filesPerPage: number;
+        hasMore: boolean;
+    };
+    changedFiles?: undefined;
+    filePagination?: undefined;
+};

package/dist/tools/github_search_pull_requests/contentResponse/nextCalls.d.ts

@@ -0,0 +1,17 @@
+import type { NormalizedPrContentRequest } from '../contentRequest.js';
+import { type QueryLike } from './pagination.js';
+export declare function nextCalls(query: QueryLike, prNumber: number, request: NormalizedPrContentRequest, firstChangedFilePath?: string): {
+    fullReview?: Record<string, unknown>;
+    getCommits?: Record<string, unknown>;
+    getReviews?: Record<string, unknown>;
+    getComments?: Record<string, unknown>;
+    getSelectedPatches?: Record<string, unknown>;
+    getAllPatches?: Record<string, unknown>;
+    getChangedFiles?: Record<string, unknown>;
+    getBody?: Record<string, unknown>;
+    target: {
+        owner: string;
+        repo: string;
+        prNumber: number;
+    };
+};

package/dist/tools/github_search_pull_requests/contentResponse/pagination.d.ts

@@ -0,0 +1,63 @@
+export type QueryLike = {
+    owner?: string;
+    repo?: string;
+    prNumber?: number;
+    page?: number;
+    filePage?: number;
+    commentPage?: number;
+    commitPage?: number;
+    itemsPerPage?: number;
+    charOffset?: number;
+    commentBodyOffset?: number;
+    charLength?: number;
+    matchString?: string;
+};
+export declare function matchStringNeedle(query: QueryLike): string | undefined;
+export declare function containsNeedle(value: unknown, needle: string): boolean;
+export type Pagination = {
+    currentPage: number;
+    totalPages: number;
+    itemsPerPage: number;
+    totalItems: number;
+    hasMore: boolean;
+    nextPage?: number;
+};
+export type TextPagination = {
+    charOffset: number;
+    charLength: number;
+    totalChars: number;
+    hasMore: boolean;
+    nextCharOffset?: number;
+};
+export type ContentPaginationEntry = Record<string, unknown> & {
+    hasMore: boolean;
+    nextQuery?: Record<string, unknown>;
+};
+export type ContentPagination = Partial<Record<'body' | 'changedFiles' | 'comments' | 'commentBody' | 'commits' | 'patches' | 'filePaths', ContentPaginationEntry>>;
+export declare function paginateItems<T>(items: T[], page?: number, itemsPerPage?: number): {
+    items: T[];
+    pagination: Pagination;
+};
+export declare function paginateText(value: string | undefined, charOffset?: number, charLength?: number): {
+    content: string;
+    pagination: {
+        nextCharOffset?: number;
+        charOffset: number;
+        charLength: number;
+        totalChars: number;
+        hasMore: boolean;
+    };
+};
+export declare function compactBody(value: unknown, max?: number): string | undefined;
+export declare function baseQuery(query: QueryLike, prNumber: number): {
+    owner: string;
+    repo: string;
+    prNumber: number;
+};
+export declare function compactQuery(value: Record<string, unknown>): Record<string, unknown>;
+export declare function continuationQuery(query: QueryLike, prNumber: number, patch: Record<string, unknown>): Record<string, unknown>;
+export declare function textContinuationQuery(query: QueryLike, prNumber: number, content: Record<string, unknown>, pagination: TextPagination, extra?: Record<string, unknown>): Record<string, unknown> | undefined;
+export declare function pageContinuationQuery(query: QueryLike, prNumber: number, content: Record<string, unknown>, pageKey: 'filePage' | 'commentPage' | 'commitPage', pagination: Pagination): Record<string, unknown> | undefined;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function readPagination(value: unknown): Pagination | undefined;
+export declare function readTextPagination(value: unknown): TextPagination | undefined;

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

@@ -1,17 +1,3 @@
 import type { NormalizedPrContentRequest } from './contentRequest.js';
-type QueryLike = {
-    owner?: string;
-    repo?: string;
-    prNumber?: number;
-    page?: number;
-    filePage?: number;
-    commentPage?: number;
-    commitPage?: number;
-    itemsPerPage?: number;
-    charOffset?: number;
-    commentBodyOffset?: number;
-    charLength?: number;
-    matchString?: string;
-};
+import { type QueryLike } from './contentResponse/pagination.js';
 export declare function shapePullRequestForContent(pr: Record<string, unknown>, query: QueryLike, request: NormalizedPrContentRequest, shouldMinify?: boolean, showContentMap?: boolean): Record<string, unknown>;
-export {};

package/dist/tools/github_search_pull_requests/execution/commitsMode.d.ts

@@ -0,0 +1,4 @@
+import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+import type { ProcessedBulkResult } from '../../../types/toolResults.js';
+import type { GitHubPullRequestSearchInput, GitHubPullRequestSearchQuery } from './types.js';
+export declare function handleCommitsMode(query: GitHubPullRequestSearchInput, parsedData: GitHubPullRequestSearchQuery | undefined, authInfo: AuthInfo | undefined): Promise<ProcessedBulkResult>;

package/dist/tools/github_search_pull_requests/execution/issuesMode.d.ts

@@ -0,0 +1,4 @@
+import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+import type { ProcessedBulkResult } from '../../../types/toolResults.js';
+import type { GitHubPullRequestSearchInput, GitHubPullRequestSearchQuery } from './types.js';
+export declare function handleIssuesMode(query: GitHubPullRequestSearchInput, parsedData: GitHubPullRequestSearchQuery | undefined, authInfo: AuthInfo | undefined): Promise<ProcessedBulkResult>;

package/dist/tools/github_search_pull_requests/execution/pullRequestsMode.d.ts

@@ -0,0 +1,4 @@
+import { createLazyProviderContext } from '../../providerExecution.js';
+import type { ProcessedBulkResult } from '../../../types/toolResults.js';
+import type { GitHubPullRequestSearchInput, GitHubPullRequestSearchQuery } from './types.js';
+export declare function handlePullRequestsMode(query: GitHubPullRequestSearchInput, parsedData: GitHubPullRequestSearchQuery | undefined, getProviderContext: ReturnType<typeof createLazyProviderContext>): Promise<ProcessedBulkResult>;

package/dist/tools/github_search_pull_requests/execution/releasesMode.d.ts

@@ -0,0 +1,4 @@
+import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+import type { ProcessedBulkResult } from '../../../types/toolResults.js';
+import type { GitHubPullRequestSearchInput, GitHubPullRequestSearchQuery } from './types.js';
+export declare function handleReleasesMode(query: GitHubPullRequestSearchInput, parsedData: GitHubPullRequestSearchQuery | undefined, authInfo: AuthInfo | undefined): Promise<ProcessedBulkResult>;

package/dist/tools/github_search_pull_requests/execution/types.d.ts

@@ -0,0 +1,6 @@
+import type { z } from 'zod';
+import { GitHubPullRequestSearchQueryLocalSchema } from '../scheme.js';
+import type { WithOptionalMeta } from '../../../types/execution.js';
+export type GitHubPullRequestSearchQuery = z.infer<typeof GitHubPullRequestSearchQueryLocalSchema>;
+export type GitHubPullRequestSearchInput = z.input<typeof GitHubPullRequestSearchQueryLocalSchema>;
+export type PartialPRQuery = WithOptionalMeta<GitHubPullRequestSearchQuery>;

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

@@ -1,7 +1,4 @@
 import { type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import type { z } from 'zod';
-import { GitHubPullRequestSearchQueryLocalSchema } from './scheme.js';
 import type { ToolExecutionArgs } from '../../types/execution.js';
-type GitHubPullRequestSearchInput = z.input<typeof GitHubPullRequestSearchQueryLocalSchema>;
+import type { GitHubPullRequestSearchInput } from './execution/types.js';
 export declare function searchMultipleGitHubPullRequests(args: ToolExecutionArgs<GitHubPullRequestSearchInput>): Promise<CallToolResult>;
-export {};

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

@@ -221,7 +221,17 @@ export declare const GitHubSearchPullRequestsOutputLocalSchema: z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         status: z.ZodOptional<z.ZodString>;
         data: z.ZodOptional<z.ZodObject<{
-            pull_requests: z.ZodOptional<z.ZodArray<z.ZodObject<{}, z.core.$loose>>>;
+            pull_requests: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{}, z.core.$loose>]>>>;
+            issues: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{}, z.core.$loose>]>>>;
+            next: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                tool: z.ZodString;
+                query: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                why: z.ZodOptional<z.ZodString>;
+                confidence: z.ZodOptional<z.ZodEnum<{
+                    exact: "exact";
+                    heuristic: "heuristic";
+                }>>;
+            }, z.core.$strip>>>;
         }, z.core.$loose>>;
     }, z.core.$loose>>>;
 }, z.core.$loose>;

package/dist/tools/github_search_repos/execution/pagination.d.ts

@@ -0,0 +1,39 @@
+import type { RepoSearchVariantExecution, RepoSearchVariantLabel, SuccessfulRepoSearchVariant } from './queryVariants.js';
+export declare function buildResultPagination(pagination: {
+    currentPage: number;
+    totalPages: number;
+    hasMore: boolean;
+    entriesPerPage?: number;
+    totalMatches?: number;
+    reportedTotalMatches?: number;
+    reachableTotalMatches?: number;
+    totalMatchesKind?: 'exact' | 'reported' | 'lowerBound';
+    totalMatchesCapped?: boolean;
+}): {
+    nextPage?: number;
+    hasMore: boolean;
+    totalMatchesCapped?: boolean;
+    totalMatchesKind?: "exact" | "reported" | "lowerBound";
+    reachableTotalMatches?: number;
+    reportedTotalMatches?: number;
+    totalMatches?: number;
+    currentPage: number;
+    totalPages: number;
+    perPage: number;
+};
+export type EffectivePagination = {
+    currentPage: number;
+    totalPages: number;
+    hasMore: boolean;
+    entriesPerPage?: number;
+    totalMatches?: number;
+    reportedTotalMatches?: number;
+    reachableTotalMatches?: number;
+    totalMatchesKind?: 'exact' | 'reported' | 'lowerBound';
+    totalMatchesCapped?: boolean;
+};
+export declare function buildPartialFailureWarnings(failedVariants: readonly {
+    label: RepoSearchVariantLabel;
+}[]): string[] | undefined;
+export declare function buildMergedPagination(variants: SuccessfulRepoSearchVariant[], dedupedCount: number): EffectivePagination | undefined;
+export declare function sumVariantRawResponseChars(variants: RepoSearchVariantExecution[]): number;

package/dist/tools/github_search_repos/execution/queryVariants.d.ts

@@ -0,0 +1,38 @@
+import type { z } from 'zod';
+import type { GitHubReposSearchSingleQuerySchema } from '@octocodeai/octocode-core/schemas';
+import type { RepoSearchResult as ProviderRepoSearchResult } from '../../../providers/types.js';
+import type { ProviderOperationResult } from '../../providerExecution.js';
+import type { WithOptionalMeta } from '../../../types/execution.js';
+type GitHubReposSearchSingleQuery = z.infer<typeof GitHubReposSearchSingleQuerySchema>;
+export type RepositorySearchExtraFields = {
+    archived?: boolean;
+    visibility?: 'public' | 'private';
+    forks?: string;
+    license?: string;
+    goodFirstIssues?: string;
+};
+export type PartialReposSearchQuery = WithOptionalMeta<GitHubReposSearchSingleQuery> & RepositorySearchExtraFields;
+export type RepoSearchVariantLabel = 'combined' | 'topics' | 'keywords';
+export interface RepoSearchVariant {
+    label: RepoSearchVariantLabel;
+    query: PartialReposSearchQuery;
+}
+export interface RepoSearchVariantExecution {
+    label: RepoSearchVariantLabel;
+    query: PartialReposSearchQuery;
+    response: ProviderOperationResult<RepoSearchVariant, ProviderRepoSearchResult>['response'];
+}
+export type SuccessfulRepoSearchVariant = RepoSearchVariantExecution & {
+    response: Extract<ProviderOperationResult<RepoSearchVariant, ProviderRepoSearchResult>, {
+        response: {
+            data: ProviderRepoSearchResult;
+        };
+    }>['response'] & {
+        data: ProviderRepoSearchResult;
+    };
+};
+export declare function hasValidTopics(query: PartialReposSearchQuery): boolean;
+export declare function hasValidKeywords(query: PartialReposSearchQuery): boolean;
+export declare function hasValidRepositorySearchParams(query: PartialReposSearchQuery): boolean;
+export declare function createSearchVariants(query: PartialReposSearchQuery): RepoSearchVariant[];
+export {};

package/dist/tools/github_search_repos/execution/ranking.d.ts

@@ -0,0 +1,4 @@
+import type { GitHubRepositoryOutput } from '@octocodeai/octocode-core/extra-types';
+import type { PartialReposSearchQuery } from './queryVariants.js';
+export declare function deduplicateRepositories(repositories: GitHubRepositoryOutput[]): GitHubRepositoryOutput[];
+export declare function rankRepositoriesByRelevance(repositories: readonly GitHubRepositoryOutput[], query: PartialReposSearchQuery): GitHubRepositoryOutput[];

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

@@ -1,75 +1,7 @@
 import { type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import type { z } from 'zod';
-import type { GitHubReposSearchSingleQuerySchema } from '@octocodeai/octocode-core/schemas';
 import type { GitHubRepositoryOutput } from '@octocodeai/octocode-core/extra-types';
-type GitHubReposSearchSingleQuery = z.infer<typeof GitHubReposSearchSingleQuerySchema>;
-import type { ToolExecutionArgs, WithOptionalMeta } from '../../types/execution.js';
-type RepositorySearchExtraFields = {
-    archived?: boolean;
-    visibility?: 'public' | 'private';
-    forks?: string;
-    license?: string;
-    goodFirstIssues?: string;
-};
-type PartialReposSearchQuery = WithOptionalMeta<GitHubReposSearchSingleQuery> & RepositorySearchExtraFields;
+import type { ToolExecutionArgs } from '../../types/execution.js';
+import { type PartialReposSearchQuery } from './execution/queryVariants.js';
+export { buildMergedPagination, buildPartialFailureWarnings, buildResultPagination, } from './execution/pagination.js';
 export declare function formatRepoLine(repo: GitHubRepositoryOutput): string;
-import type { RepoSearchResult as ProviderRepoSearchResult } from '../../providers/types.js';
-import { type ProviderOperationResult } from '../providerExecution.js';
-type RepoSearchVariantLabel = 'combined' | 'topics' | 'keywords';
-interface RepoSearchVariant {
-    label: RepoSearchVariantLabel;
-    query: PartialReposSearchQuery;
-}
-interface RepoSearchVariantExecution {
-    label: RepoSearchVariantLabel;
-    query: PartialReposSearchQuery;
-    response: ProviderOperationResult<RepoSearchVariant, ProviderRepoSearchResult>['response'];
-}
-type SuccessfulRepoSearchVariant = RepoSearchVariantExecution & {
-    response: Extract<ProviderOperationResult<RepoSearchVariant, ProviderRepoSearchResult>, {
-        response: {
-            data: ProviderRepoSearchResult;
-        };
-    }>['response'] & {
-        data: ProviderRepoSearchResult;
-    };
-};
-export declare function buildResultPagination(pagination: {
-    currentPage: number;
-    totalPages: number;
-    hasMore: boolean;
-    entriesPerPage?: number;
-    totalMatches?: number;
-    reportedTotalMatches?: number;
-    reachableTotalMatches?: number;
-    totalMatchesKind?: 'exact' | 'reported' | 'lowerBound';
-    totalMatchesCapped?: boolean;
-}): {
-    nextPage?: number;
-    hasMore: boolean;
-    totalMatchesCapped?: boolean;
-    totalMatchesKind?: "exact" | "reported" | "lowerBound";
-    reachableTotalMatches?: number;
-    reportedTotalMatches?: number;
-    totalMatches?: number;
-    currentPage: number;
-    totalPages: number;
-    perPage: number;
-};
-type EffectivePagination = {
-    currentPage: number;
-    totalPages: number;
-    hasMore: boolean;
-    entriesPerPage?: number;
-    totalMatches?: number;
-    reportedTotalMatches?: number;
-    reachableTotalMatches?: number;
-    totalMatchesKind?: 'exact' | 'reported' | 'lowerBound';
-    totalMatchesCapped?: boolean;
-};
-export declare function buildPartialFailureWarnings(failedVariants: readonly {
-    label: RepoSearchVariantLabel;
-}[]): string[] | undefined;
-export declare function buildMergedPagination(variants: SuccessfulRepoSearchVariant[], dedupedCount: number): EffectivePagination | undefined;
 export declare function searchMultipleGitHubRepos(args: ToolExecutionArgs<PartialReposSearchQuery>): Promise<CallToolResult>;
-export {};

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

@@ -71,6 +71,14 @@ export declare const GitHubSearchRepositoriesOutputLocalSchema: z.ZodObject<{
                 nextPage: z.ZodOptional<z.ZodNumber>;
                 pageSize: z.ZodOptional<z.ZodNumber>;
                 totalItems: z.ZodOptional<z.ZodNumber>;
+                perPage: z.ZodOptional<z.ZodNumber>;
+                totalFound: z.ZodOptional<z.ZodNumber>;
+                returned: z.ZodOptional<z.ZodNumber>;
+                totalMatches: z.ZodOptional<z.ZodNumber>;
+                reportedTotalMatches: z.ZodOptional<z.ZodNumber>;
+                reachableTotalMatches: z.ZodOptional<z.ZodNumber>;
+                totalResults: z.ZodOptional<z.ZodNumber>;
+                itemsPerPage: z.ZodOptional<z.ZodNumber>;
                 totalMatchesKind: z.ZodOptional<z.ZodEnum<{
                     exact: "exact";
                     reported: "reported";

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

@@ -15,6 +15,8 @@ export interface GitHubRepositoryStructureResult {
         truncated: boolean;
         filtered: boolean;
         originalCount: number;
+        /** True when Git Trees reported truncation — listing may be incomplete. */
+        incompleteTree?: boolean;
     };
     structure: Record<string, GitHubRepoStructureDirectoryEntry>;
     fileSizeMap?: Record<string, Record<string, number>>;

package/dist/tools/local_fetch_content/fetchContent/extraction.d.ts

@@ -0,0 +1,15 @@
+import type { LocalGetFileContentToolResult } from '@octocodeai/octocode-core/extra-types';
+import type { FetchContentQuery } from '../scheme.js';
+export interface ExtractionState {
+    resultContent?: string;
+    isPartial: boolean;
+    actualStartLine?: number;
+    actualEndLine?: number;
+    matchRanges?: Array<{
+        start: number;
+        end: number;
+    }>;
+    warnings?: string[];
+    earlyResult?: LocalGetFileContentToolResult;
+}
+export declare function buildExtractionState(query: FetchContentQuery, content: string, _defaultOutputCharLength: number): ExtractionState;

package/dist/tools/local_fetch_content/fetchContent/pagination.d.ts

@@ -0,0 +1,38 @@
+import { applyPagination } from '../../../utils/pagination/core.js';
+import type { LocalGetFileContentToolResult } from '@octocodeai/octocode-core/extra-types';
+import type { FetchContentQuery } from '../scheme.js';
+import { type FileStats } from './validation.js';
+import type { ExtractionState } from './extraction.js';
+export type ContentView = 'none' | 'standard' | 'symbols';
+export interface ContentWindow {
+    /** The windowed (paginated) slice of the input content. */
+    windowedContent: string;
+    pagination: ReturnType<typeof applyPagination>;
+    /** Requested/auto page size (undefined when no windowing applies). */
+    effectiveCharLength: number | undefined;
+    /** Explicit charOffset requested by the caller (0 when absent). */
+    explicitCharOffset: number;
+    autoPaginated: boolean;
+    /** Warning emitted when the content was auto-paginated (else undefined). */
+    autoPaginateWarning?: string;
+    chunkMode: 'semantic' | 'char-limit';
+    nextBlockChar?: number;
+    /** Ready continuation query for the next char page (undefined when !hasMore). */
+    next?: {
+        continueChars: {
+            tool: 'localGetFileContent';
+            query: {
+                path: string;
+                charOffset: number;
+                charLength: number;
+                minify: FetchContentQuery['minify'];
+            };
+        };
+    };
+    /** Whether pagination fields should be emitted on the result. */
+    showPagination: boolean;
+}
+export declare function paginateContentWindow(content: string, query: FetchContentQuery, defaultOutputCharLength: number): Promise<ContentWindow>;
+export declare function buildSuccessResult(query: FetchContentQuery, extraction: ExtractionState, fileStats: FileStats, totalLines: number, defaultOutputCharLength: number, shouldMinify?: boolean, contentView?: ContentView): Promise<LocalGetFileContentToolResult>;
+export declare function buildSymbolsSkeletonResult(query: FetchContentQuery, skeleton: string, totalLines: number, sourceChars: number, sourceBytes: number, secretWarning: string | undefined, defaultOutputCharLength: number): Promise<LocalGetFileContentToolResult>;
+export declare function withContentView(result: LocalGetFileContentToolResult, contentView: ContentView): LocalGetFileContentToolResult;

package/dist/tools/local_fetch_content/fetchContent/validation.d.ts

@@ -0,0 +1,26 @@
+import { stat } from 'fs/promises';
+import type { LocalGetFileContentToolResult } from '@octocodeai/octocode-core/extra-types';
+import type { FetchContentQuery } from '../scheme.js';
+export type FileStats = NonNullable<Awaited<ReturnType<typeof stat>>>;
+export declare function sourceSizeFields(sourceChars: number, sourceBytes: number): {
+    sourceChars: number;
+    sourceBytes: number;
+} | {
+    sourceChars: number;
+    sourceBytes?: undefined;
+};
+export declare function withSourceSize(result: LocalGetFileContentToolResult, sourceChars: number, sourceBytes: number): LocalGetFileContentToolResult;
+export declare function validateExtractionOptions(query: FetchContentQuery): LocalGetFileContentToolResult | null;
+export declare function getFileStatsOrError(query: FetchContentQuery, absolutePath: string): Promise<{
+    fileStats?: FileStats;
+    errorResult?: LocalGetFileContentToolResult;
+}>;
+export declare function shouldFailForLargeFile(query: FetchContentQuery, fileSizeKB: number): boolean;
+export declare function createLargeFileErrorResult(query: FetchContentQuery, absolutePath: string, fileSizeKB: number): LocalGetFileContentToolResult;
+export declare function createBinaryFileErrorResult(query: FetchContentQuery, absolutePath: string): LocalGetFileContentToolResult;
+export declare function isLikelyBinaryFile(filePath: string): Promise<boolean>;
+export declare function readFileContentOrError(query: FetchContentQuery, absolutePath: string): Promise<{
+    content?: string;
+    errorResult?: LocalGetFileContentToolResult;
+}>;
+export declare function createNoMatchesResult(_query: FetchContentQuery, totalLines: number): LocalGetFileContentToolResult;

package/dist/tools/local_fetch_content/fetchContent.d.ts

@@ -1,4 +1,6 @@
 import type { LocalGetFileContentToolResult } from '@octocodeai/octocode-core/extra-types';
 import type { FetchContentQuery } from './scheme.js';
+import { type ContentView } from './fetchContent/pagination.js';
+export type { ContentView };
 export declare function fetchContent(query: FetchContentQuery): Promise<LocalGetFileContentToolResult>;
 export declare function finalizeFetchContentResult(result: LocalGetFileContentToolResult, _query: FetchContentQuery, _totalLines: number): LocalGetFileContentToolResult;