@octocodeai/octocode-tools-core 17.0.2 → 18.1.0

package/dist/github/canonicalRepo.d.ts

@@ -0,0 +1,14 @@
+import { OctokitWithThrottling } from './client.js';
+/**
+ * Resolve an owner/repo to its canonical name, following GitHub repository
+ * renames/redirects (the Search API does NOT follow renames, so a search
+ * scoped to a stale name silently returns zero results — a false absence).
+ * `repos.get` transparently redirects to the new location, so its `full_name`
+ * is authoritative. Returns the original pair on any failure (network, 404,
+ * private) so callers degrade gracefully rather than blocking the search.
+ */
+export declare function resolveCanonicalOwnerRepo(octokit: InstanceType<typeof OctokitWithThrottling>, owner: string, repo: string): Promise<{
+    owner: string;
+    repo: string;
+    renamed: boolean;
+}>;

package/dist/github/codeSearch/matchPositions.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Re-anchor GitHub text-match positions after the fragment has been
+ * transformed (sanitized/minified). GitHub's indices point into the RAW
+ * fragment; the fragment we return to the agent is not that string, so raw
+ * indices would point at the wrong text. Each position is re-located by
+ * searching for its matched TEXT in the transformed fragment (forward scan
+ * keeps repeated occurrences distinct and ordered). A match the transform
+ * removed (e.g. a comment the minifier stripped) is dropped rather than
+ * emitted with a stale offset — a missing anchor is honest, a wrong one lies.
+ */
+export declare function recomputeMatchPositions(rawFragment: string, rawPositions: ReadonlyArray<readonly [number, number]>, transformedFragment: string): Array<[number, number]>;

package/dist/github/codeSearch.d.ts

@@ -4,5 +4,6 @@ import type { GitHubCodeSearchQuerySchema } from '@octocodeai/octocode-core/sche
 type GitHubCodeSearchQuery = z.infer<typeof GitHubCodeSearchQuerySchema>;
 import type { WithOptionalMeta } from '../types/execution.js';
 import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
+import { recomputeMatchPositions } from './codeSearch/matchPositions.js';
+export { recomputeMatchPositions };
 export declare function searchGitHubCodeAPI(params: WithOptionalMeta<GitHubCodeSearchQuery>, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubAPIResponse<OptimizedCodeSearchResult>>;
-export {};

package/dist/github/compare.d.ts

@@ -0,0 +1,51 @@
+import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+import type { GitHubAPIResponse, HistoryCommitFile } from './githubAPI.js';
+export type CompareResult = {
+    type: 'compare';
+    owner: string;
+    repo: string;
+    base: string;
+    head: string;
+    /** ahead | behind | diverged | identical */
+    status: string;
+    aheadBy: number;
+    behindBy: number;
+    totalCommits: number;
+    commits: Array<{
+        sha: string;
+        messageHeadline: string;
+        author: string;
+        date: string;
+    }>;
+    /** File count when includeDiff is off (lean default). */
+    changedFiles?: number;
+    /** Per-file diffs when includeDiff is on (windowed + paginated). */
+    files?: HistoryCommitFile[];
+    /** File-list pagination when includeDiff is on. */
+    filesPagination?: {
+        currentPage: number;
+        totalPages: number;
+        itemsPerPage: number;
+        totalFiles: number;
+        hasMore: boolean;
+        nextFilePage?: number;
+    };
+};
+/**
+ * Compare mode of ghSearchCommits: diff two refs (base...head) via GitHub's
+ * compare endpoint. Returns ahead/behind counts, the commits between them, and
+ * a lean changed-file count (or full diffs when includeDiff is set).
+ */
+export declare function compareRefs(params: {
+    owner: string;
+    repo: string;
+    base: string;
+    head: string;
+    includeDiff?: boolean;
+    /** Restrict the diff to a single file path (searchable scope). */
+    path?: string;
+    filePage?: number;
+    itemsPerPage?: number;
+    charOffset?: number;
+    charLength?: number;
+}, authInfo?: AuthInfo): Promise<GitHubAPIResponse<CompareResult>>;

package/dist/github/dateWindow.d.ts

@@ -0,0 +1,4 @@
+export declare function resolveDateWindow(value: string): {
+    value?: string;
+    warning?: string;
+};

package/dist/github/discussions.d.ts

@@ -0,0 +1,45 @@
+import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+import type { GitHubAPIResponse } from './githubAPI.js';
+type DiscussionRow = {
+    number: number;
+    title: string;
+    url: string;
+    author?: string;
+    category?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    /** True when a comment has been accepted as the answer (Q&A categories). */
+    answered?: true;
+    upvotes?: number;
+    comments?: number;
+};
+export type DiscussionsResult = {
+    type: 'discussions';
+    owner: string;
+    repo: string;
+    totalCount: number;
+    discussions: DiscussionRow[];
+    pagination: {
+        perPage: number;
+        hasMore: boolean;
+        /** Opaque cursor to pass back as `after` for the next page. */
+        nextCursor?: string;
+    };
+    /**
+     * Whether the repository has Discussions enabled at all. Omitted (not
+     * `false`) when the repo-level probe itself failed/was inconclusive — a
+     * `totalCount:0` response is otherwise ambiguous between "disabled" and
+     * "enabled, nothing posted yet", which this field disambiguates without a
+     * second call.
+     */
+    hasDiscussionsEnabled?: boolean;
+};
+type FetchDiscussionsParams = {
+    owner: string;
+    repo: string;
+    keywords?: string[];
+    perPage: number;
+    after?: string;
+};
+export declare function fetchDiscussions(params: FetchDiscussionsParams, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubAPIResponse<DiscussionsResult>>;
+export {};

package/dist/github/githubAPI.d.ts

@@ -15,8 +15,8 @@ export interface PRReviewInfo {
     user: string;
     state: string;
     body: string;
-    submitted_at?: string;
-    commit_id?: string;
+    submittedAt?: string;
+    commitId?: string;
 }
 export interface CommitFileInfo {
     filename: string;
@@ -57,7 +57,6 @@ export interface HistoryCommit {
     /** Present when the message body was cut at 500 chars — the '…' is a real cut. */
     messageTruncated?: true;
     messageHeadline: string;
-    url: string;
     author: {
         name: string;
         email: string;
@@ -103,6 +102,8 @@ export interface HistoryResult {
         hasMore: boolean;
         nextPage?: number;
     };
+    /** Date-window / diff-fallback explanations (e.g. committer-date note). */
+    warnings?: string[];
 }
 export type GetContentParameters = RestEndpointMethodTypes['repos']['getContent']['parameters'];
 export type SearchCodeParameters = RestEndpointMethodTypes['search']['code']['parameters'];
@@ -183,12 +184,12 @@ export interface PRCommentItem {
     id: string;
     user: string;
     body: string;
-    created_at: string;
-    updated_at: string;
+    createdAt: string;
+    updatedAt: string;
     commentType?: 'discussion' | 'review_inline';
     path?: string;
     line?: number;
-    in_reply_to_id?: number | null;
+    inReplyToId?: number | null;
 }
 export type GitHubPullRequestItem = Pick<IssueSearchResultItem, 'number' | 'title' | 'body' | 'state' | 'created_at' | 'updated_at' | 'closed_at' | 'url' | 'draft'> & {
     author: string;
@@ -223,7 +224,6 @@ export interface GitHubPullRequestsSearchParams {
     assignee?: string;
     mentions?: string;
     commenter?: string;
-    involves?: string;
     'reviewed-by'?: string;
     'review-requested'?: string;
     head?: string;
@@ -234,7 +234,6 @@ export interface GitHubPullRequestsSearchParams {
     closed?: string;
     comments?: number | string;
     reactions?: number | string;
-    interactions?: number | string;
     label?: string | string[];
     milestone?: string;
     language?: string;
@@ -242,12 +241,7 @@ export interface GitHubPullRequestsSearchParams {
     review?: 'none' | 'required' | 'approved' | 'changes_requested';
     locked?: boolean;
     visibility?: 'public' | 'private';
-    'team-mentions'?: string;
     project?: string;
-    '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';

package/dist/github/history/commitFiles.d.ts

@@ -0,0 +1,39 @@
+import type { HistoryCommitFile } from '../githubAPI.js';
+export declare function windowPatch(patch: string | undefined, charOffset: number | undefined, charLength: number | undefined): {
+    patch: string;
+    patchPagination?: {
+        charOffset: number;
+        charLength: number;
+        totalChars: number;
+        hasMore: boolean;
+        nextCharOffset?: number;
+    };
+} | undefined;
+/**
+ * Shape a commit's raw changed-file rows into the windowed, paginated
+ * `files` + `filesPagination` payload. Shared by repo/dir mode and the
+ * file-mode directory fallback so both emit identical structure.
+ */
+export declare function shapeCommitDirFiles(rawFiles: ReadonlyArray<{
+    filename: string;
+    status?: string;
+    additions?: number;
+    deletions?: number;
+    patch?: string;
+    previous_filename?: string;
+}>, params: {
+    filePage?: number;
+    itemsPerPage?: number;
+    charOffset?: number;
+    charLength?: number;
+}): {
+    files: HistoryCommitFile[];
+    filesPagination: {
+        currentPage: number;
+        totalPages: number;
+        itemsPerPage: number;
+        totalFiles: number;
+        hasMore: boolean;
+        nextFilePage?: number;
+    };
+};

package/dist/github/history.d.ts

@@ -11,6 +11,7 @@ type FetchHistoryParams = {
     since?: string;
     until?: string;
     author?: string;
+    committer?: string;
     page: number;
     perPage: number;
     filePage?: number;

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

@@ -3,8 +3,8 @@ export type IssueCommentRow = {
     id: string;
     user: string;
     body: string;
-    created_at: string;
-    updated_at: string;
+    createdAt: string;
+    updatedAt: string;
     commentType: 'discussion';
 };
 export type IssueRow = {
@@ -13,10 +13,9 @@ export type IssueRow = {
     state: string;
     author: string;
     labels: string[];
-    created_at: string;
-    updated_at: string;
-    closed_at?: string;
-    url: string;
+    createdAt: string;
+    updatedAt: string;
+    closedAt?: string;
     body?: string;
     comments?: IssueCommentRow[];
     contentPagination?: {
@@ -41,9 +40,10 @@ export type IssuesResult = {
     owner: string;
     repo: string;
     issues: IssueRow[] | string[];
-    total_count?: number;
+    totalCount?: number;
     effectiveQuery?: string;
-    incomplete_results?: boolean;
+    warnings?: string[];
+    incompleteResults?: boolean;
     pagination?: {
         currentPage: number;
         perPage: number;

package/dist/github/prTransformation.d.ts

@@ -44,27 +44,27 @@ interface TextPaginationInfo {
     nextCharOffset?: number;
 }
 export declare function formatPRForResponse(pr: GitHubPullRequestItem, options?: PRResponseFormatOptions): {
-    _sanitization_warnings: string[];
-    comment_details_paginated?: boolean;
-    comment_details: {
-        body_pagination?: TextPaginationInfo;
+    sanitizationWarnings: string[];
+    commentDetailsPaginated?: boolean;
+    commentDetails: {
+        bodyPagination?: TextPaginationInfo;
         body: string;
         id: string;
         user: string;
-        created_at: string;
-        updated_at: string;
+        createdAt: string;
+        updatedAt: string;
         commentType?: "discussion" | "review_inline";
         path?: string;
         line?: number;
-        in_reply_to_id?: number | null;
+        inReplyToId?: number | null;
     }[];
-    comment_details_shown: number;
-    comment_details_total: number;
-    commit_details: import("./githubAPI.js").CommitInfo[];
+    commentDetailsShown: number;
+    commentDetailsTotal: number;
+    commitDetails: import("./githubAPI.js").CommitInfo[];
     reviews: import("./githubAPI.js").PRReviewInfo[];
-    file_changes: {
+    fileChanges: {
         filename: string;
-        status: "modified" | "unchanged" | "added" | "removed" | "renamed" | "copied" | "changed";
+        status: "modified" | "added" | "removed" | "renamed" | "copied" | "changed" | "unchanged";
         additions: number;
         deletions: number;
         patch: string;
@@ -72,18 +72,18 @@ export declare function formatPRForResponse(pr: GitHubPullRequestItem, options?:
     commits: number;
     additions: number;
     deletions: number;
-    changed_files: number;
-    comment_details_breakdown: {
-        inline_review: number;
+    changedFiles: number;
+    commentDetailsBreakdown: {
+        inlineReview: number;
         discussion: number;
     };
     comments: number;
-    body_pagination?: TextPaginationInfo;
+    bodyPagination?: TextPaginationInfo;
     body: string;
-    base_sha?: string;
-    base_ref: string;
-    head_sha?: string;
-    head_ref: string;
+    baseSha?: string;
+    baseRef: string;
+    headSha?: string;
+    headRef: string;
     labels?: {
         id: number;
         name: string;
@@ -91,14 +91,13 @@ export declare function formatPRForResponse(pr: GitHubPullRequestItem, options?:
     }[];
     number: number;
     title: string;
-    url: string;
     state: "open" | "closed";
     draft: boolean;
     merged: boolean;
-    created_at: string;
-    updated_at: string;
-    closed_at: string;
-    merged_at: string;
+    createdAt: string;
+    updatedAt: string;
+    closedAt: string;
+    mergedAt: string;
     author: string;
 };
 export declare function normalizeOwnerRepo(params: GitHubPullRequestsSearchParams): {

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

@@ -15,7 +15,6 @@ export declare abstract class BaseQueryBuilder {
     addEngagementFilters(params: {
         comments?: number | string;
         reactions?: number | string;
-        interactions?: number | string;
     }): this;
     addOrganizationFilters(params: {
         label?: string | string[];

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

@@ -9,21 +9,15 @@ export type IssueSearchParams = {
     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';

package/dist/github/releases.d.ts

@@ -1,5 +1,11 @@
 import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
 import type { GitHubAPIResponse } from './githubAPI.js';
+type ReleaseAsset = {
+    name: string;
+    size: number;
+    downloadCount: number;
+    url: string;
+};
 type ReleaseRow = {
     tagName: string;
     name?: string;
@@ -8,7 +14,8 @@ type ReleaseRow = {
     draft?: true;
     /** Marks the release GitHub reports as "latest" (stable, non-prerelease). */
     latest?: true;
-    url?: string;
+    /** Downloadable assets (opt-in via includeAssets). */
+    assets?: ReleaseAsset[];
 };
 export type ReleasesResult = {
     type: 'releases';
@@ -32,6 +39,7 @@ type FetchReleasesParams = {
     repo: string;
     page: number;
     perPage: number;
+    includeAssets?: boolean;
 };
 export declare function fetchReleases(params: FetchReleasesParams, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubAPIResponse<ReleasesResult>>;
 export {};

package/dist/github/responseHeaders.d.ts

@@ -1,3 +1,9 @@
 export declare function normalizeResponseHeaders(headers: unknown): Record<string, string>;
+/**
+ * A one-line rate-limit warning when the quota on THIS response is low — read
+ * from the `x-ratelimit-*` headers GitHub already returns, so it costs no extra
+ * API call. Returns undefined when quota is healthy or the headers are absent.
+ */
+export declare function rateLimitWarning(headers: unknown): string | undefined;
 /** Prefer strong ETag; fall back to weak / case variants GitHub may emit. */
 export declare function extractEtag(headers: unknown): string | undefined;

package/dist/index.d.ts

@@ -55,7 +55,11 @@ export * from './tools/github_search_pull_requests/contentRequest.js';
 export * from './tools/github_search_pull_requests/contentResponse.js';
 export * from './tools/github_search_pull_requests/execution.js';
 export * from './tools/github_search_pull_requests/scheme.js';
+export * from './tools/github_search_pull_requests/splitSchemes.js';
+export * from './tools/github_search_pull_requests/splitExecutions.js';
 export * from './tools/github_search_pull_requests/types.js';
+export * from './tools/github_search_discussions/scheme.js';
+export * from './tools/github_search_discussions/execution.js';
 export * from './tools/github_search_repos/execution.js';
 export * from './tools/github_search_repos/scheme.js';
 export * from './tools/github_view_repo_structure/constants.js';
@@ -69,6 +73,9 @@ export * from './tools/local_fetch_content/scheme.js';
 export * from './tools/local_find_files/execution.js';
 export * from './tools/local_find_files/findFiles.js';
 export * from './tools/local_find_files/scheme.js';
+export * from './tools/local_dead_code/execution.js';
+export * from './tools/local_dead_code/local_dead_code.js';
+export * from './tools/local_dead_code/scheme.js';
 export * from './tools/local_ripgrep/execution.js';
 export * from './tools/local_ripgrep/patternValidation.js';
 export * from './tools/local_ripgrep/ripgrepExecutor.js';
@@ -79,7 +86,6 @@ export * from './tools/local_view_structure/execution.js';
 export * from './tools/local_view_structure/local_view_structure.js';
 export * from './tools/local_view_structure/scheme.js';
 export * from './tools/local_view_structure/structureFilters.js';
-export * from './tools/oql_search/execution.js';
 export * from './tools/lsp/semantic_content/execution.js';
 export * from './tools/lsp/semantic_content/index.js';
 export * from './tools/lsp/semantic_content/scheme.js';
@@ -102,8 +108,6 @@ export * from './tools/toolMetadata/types.js';
 export * from './tools/directToolCatalog.js';
 export * from './tools/toolNames.js';
 export * from './tools/utils.js';
-export { OqlSearchInputSchema } from './oql/schema.js';
-export type { OqlSearchInput } from './oql/types.js';
 export * from './types/bulk.js';
 export * from './types/execution.js';
 export * from './types/promise.js';
@@ -159,12 +163,9 @@ export { maskSensitiveData } from '@octocodeai/octocode-engine/mask';
 export { configureSecurity } from '@octocodeai/octocode-engine/withSecurityValidation';
 export type { OAuthToken, StoredCredentials, StoreResult, DeleteResult, CredentialsStore, TokenSource, GetCredentialsOptions, ResolvedToken, TokenWithRefreshResult, ResolvedTokenWithRefresh, RefreshResult, FullTokenResolution, GhCliTokenGetter, } from './shared/credentials/index.js';
 export { storeCredentials, getCredentials, getCredentialsSync, deleteCredentials, updateToken, invalidateCredentialsCache, getToken, getTokenSync, resolveToken, getTokenWithRefresh, resolveTokenWithRefresh, refreshAuthToken, resolveTokenFull, resetTokenResolution, listStoredHosts, listStoredHostsSync, hasCredentials, hasCredentialsSync, isTokenExpired, isRefreshTokenExpired, getCredentialsFilePath, readCredentialsStore, encrypt, decrypt, ensureOctocodeDir, OCTOCODE_DIR, CREDENTIALS_FILE, KEY_FILE, getGhCliToken, } from './shared/credentials/index.js';
-export { ENV_TOKEN_VARS, type EnvTokenVar, getTokenFromEnv, getEnvTokenSource, hasEnvToken, resolveEnvToken, } from '@octocodeai/config';
 export { isWindows, isMac, isLinux, HOME, getAppDataPath, getLocalAppDataPath, getPlatformName, getArchitecture, } from './shared/platform/index.js';
 export type { ToolCharSavingsStats, GitHubCacheHitStats, StatsCounterMap, SessionTotalUsageStats, SessionStats, PersistedSession, PersistedStats, SessionUpdateResult, SessionOptions, } from './shared/session/index.js';
 export { SESSION_FILE, STATS_FILE, getSessionId, getOrCreateSession, updateSessionStats, resetSessionStats, flushSession, flushSessionSync, deleteSession, incrementToolCalls, incrementErrors, incrementRateLimits, incrementRateLimitByProvider, incrementGitHubCacheHits, incrementGitHubCacheRateLimits, incrementPackageRegistryFailures, incrementToolCharSavings, _resetSessionState, } from './shared/session/index.js';
-export type { OctocodeConfig, ResolvedConfig, ValidationResult, LoadConfigResult, GitHubConfigOptions, LocalConfigOptions, ToolsConfigOptions, NetworkConfigOptions, LspConfigOptions, OutputConfigOptions, OutputPaginationConfigOptions, RequiredGitHubConfig, RequiredLocalConfig, RequiredToolsConfig, RequiredNetworkConfig, RequiredLspConfig, RequiredOutputConfig, RequiredOutputPaginationConfig, RuntimeSurface, } from '@octocodeai/config';
-export { CONFIG_SCHEMA_VERSION, CONFIG_FILE_NAME, DEFAULT_CONFIG, DEFAULT_GITHUB_CONFIG, DEFAULT_LOCAL_CONFIG, DEFAULT_TOOLS_CONFIG, DEFAULT_NETWORK_CONFIG, DEFAULT_LSP_CONFIG, DEFAULT_OUTPUT_CONFIG, MIN_TIMEOUT, MAX_TIMEOUT, MIN_RETRIES, MAX_RETRIES, MIN_OUTPUT_DEFAULT_CHAR_LENGTH, MAX_OUTPUT_DEFAULT_CHAR_LENGTH, getConfigFilePath, loadConfig, loadConfigSync, configExists, validateConfig, getConfig, getConfigSync, reloadConfig, resolveConfig, resolveConfigSync, invalidateConfigCache, getConfigValue, _resetConfigCache, _getCacheState, setRuntimeSurface, getRuntimeSurface, } from '@octocodeai/config';
 export { OctocodeConfigSchema } from './shared/config/schemas.js';
 export { OCTOCODE_HOME, getDefaultOctocodeHome, getOctocodeDir, paths, ensureHome, ensureTmp, ensureClone, ensureRepos, ensureTree, } from './shared/paths.js';
 export { getDirectorySizeBytes, formatBytes } from './shared/fs-utils.js';