@octocodeai/octocode-tools-core 16.3.0 → 16.6.0

package/dist/errors/pathUtils.d.ts

@@ -1 +1 @@
-export { redactPath } from 'octocode-security/pathUtils';
+export { redactPath } from '@octocodeai/octocode-engine/pathUtils';

package/dist/github/directoryFetch.d.ts

@@ -1,5 +1,6 @@
 import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
-import type { DirectoryFetchResult } from '../tools/github_fetch_content/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>;

package/dist/github/githubAPI.d.ts

@@ -1,5 +1,6 @@
 import type { components } from '@octokit/openapi-types';
 import type { RestEndpointMethodTypes } from '@octokit/plugin-rest-endpoint-methods';
+import type { DiffPreview } from '../utils/parsers/diff.js';
 export type Repository = components['schemas']['full-repository'];
 export type ContentDirectoryEntry = components['schemas']['content-directory'][number];
 export type CodeSearchResultItem = components['schemas']['code-search-result-item'];
@@ -38,6 +39,14 @@ export interface HistoryCommitFile {
     additions: number;
     deletions: number;
     patch?: string;
+    patchPagination?: {
+        charOffset: number;
+        charLength: number;
+        totalChars: number;
+        hasMore: boolean;
+        nextCharOffset?: number;
+    };
+    diff?: DiffPreview;
     previousFilename?: string;
 }
 export interface HistoryCommit {
@@ -60,8 +69,24 @@ export interface HistoryCommit {
     deletions?: number;
     status?: string;
     patch?: string;
+    patchPagination?: {
+        charOffset: number;
+        charLength: number;
+        totalChars: number;
+        hasMore: boolean;
+        nextCharOffset?: number;
+    };
+    diff?: DiffPreview;
     previousFilename?: string;
     files?: HistoryCommitFile[];
+    filesPagination?: {
+        currentPage: number;
+        totalPages: number;
+        itemsPerPage: number;
+        totalFiles: number;
+        hasMore: boolean;
+        nextFilePage?: number;
+    };
 }
 export interface HistoryResult {
     type: 'file' | 'repo';
@@ -70,7 +95,7 @@ export interface HistoryResult {
     path?: string;
     commits: HistoryCommit[];
     pagination: {
-        page: number;
+        currentPage: number;
         perPage: number;
         hasMore: boolean;
         nextPage?: number;
@@ -144,6 +169,12 @@ export type OptimizedCodeSearchResult = {
         uniqueFileCount?: number;
     };
     nonExistentScope?: boolean;
+    /**
+     * GitHub returned `incomplete_results: true` (the search index timed out or
+     * could not fully complete). Empty or partial `items` may be a FALSE NEGATIVE
+     * — distinct from a genuine no-match. Surfaced so callers aren't blind.
+     */
+    incompleteResults?: boolean;
 };
 export interface PRCommentItem {
     id: string;

package/dist/github/history.d.ts

@@ -11,6 +11,9 @@ export declare function fetchHistory(params: {
     author?: string;
     page: number;
     perPage: number;
+    filePage?: number;
+    itemsPerPage?: number;
     includeDiff: boolean;
+    charOffset?: number;
     charLength?: number;
 }, authInfo?: AuthInfo): Promise<GitHubAPIResponse<HistoryResult>>;

package/dist/github/prTransformation.d.ts

@@ -64,7 +64,7 @@ export declare function formatPRForResponse(pr: GitHubPullRequestItem, options?:
     reviews: import("./githubAPI.js").PRReviewInfo[];
     file_changes: {
         filename: string;
-        status: "added" | "removed" | "modified" | "renamed" | "copied" | "changed" | "unchanged";
+        status: "modified" | "unchanged" | "added" | "removed" | "renamed" | "copied" | "changed";
         additions: number;
         deletions: number;
         patch: string;

package/dist/github/repoStructureRecursive.d.ts

@@ -1,3 +1,9 @@
 import type { GitHubApiFileItem } from '../tools/github_view_repo_structure/types.js';
 import { OctokitWithThrottling } from './client.js';
+/**
+ * Number of subtrees that failed to fetch (non-propagating errors) while
+ * building this recursive listing. Lets callers surface a "partial tree"
+ * warning instead of presenting a partial tree as complete.
+ */
+export declare function getRecursiveFetchFailureCount(value: unknown): number;
 export declare function fetchDirectoryContentsRecursivelyAPI(octokit: InstanceType<typeof OctokitWithThrottling>, owner: string, repo: string, branch: string, path: string, currentDepth: number, maxDepth: number, visitedPaths?: Set<string>): Promise<GitHubApiFileItem[]>;

package/dist/index.d.ts

@@ -1,6 +1,4 @@
 export * from './security/bridge.js';
-export * from './commands/BaseCommandBuilder.js';
-export * from './commands/RipgrepCommandBuilder.js';
 export * from './config.js';
 export * from './errors/domainErrors.js';
 export * from './errors/errorFactories.js';
@@ -26,7 +24,6 @@ export * from './github/repoStructure.js';
 export * from './github/repoStructurePagination.js';
 export * from './github/repoStructureRecursive.js';
 export * from './github/responseHeaders.js';
-export * from './hints/types.js';
 export * from './providers/capabilities.js';
 export * from './providers/factory.js';
 export * from './providers/github/githubContent.js';
@@ -75,10 +72,8 @@ 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_ripgrep/execution.js';
-export * from './tools/local_ripgrep/grepFallbackExecutor.js';
 export * from './tools/local_ripgrep/patternValidation.js';
 export * from './tools/local_ripgrep/ripgrepExecutor.js';
-export * from './tools/local_ripgrep/ripgrepParser.js';
 export * from './tools/local_ripgrep/ripgrepResultBuilder.js';
 export * from './tools/local_ripgrep/scheme.js';
 export * from './tools/local_ripgrep/searchContentRipgrep.js';
@@ -86,6 +81,7 @@ 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';
@@ -108,9 +104,10 @@ 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/metadata.js';
 export * from './types/promise.js';
 export * from './types/responseTypes.js';
 export * from './types/server.js';
@@ -119,12 +116,11 @@ export * from './types/toolResults.js';
 export * from './utils/core/bestEffort.js';
 export * from './utils/core/compare.js';
 export * from './utils/core/constants.js';
+export * from './utils/core/lines.js';
 export * from './utils/core/promise.js';
 export * from './utils/core/safeRegex.js';
 export * from './utils/environment/environmentDetection.js';
-export * from './utils/exec/commandAvailability.js';
 export * from './utils/exec/npm.js';
-export * from './utils/exec/ripgrepBinary.js';
 export * from './utils/exec/safe.js';
 export * from './utils/exec/spawn.js';
 export * from './utils/file/byteOffset.js';
@@ -142,7 +138,6 @@ export * from './utils/pagination/boundary.js';
 export * from './utils/pagination/charLimit.js';
 export * from './utils/pagination/core.js';
 export * from './utils/pagination/hints.js';
-export * from './utils/pagination/outputSizeLimit.js';
 export * from './utils/pagination/types.js';
 export * from './utils/parsers/diff.js';
 export * from './utils/parsers/ripgrep.js';
@@ -153,7 +148,6 @@ export * from './utils/response/charSavings.js';
 export * from './utils/response/error.js';
 export * from './utils/response/groupedFinalizer.js';
 export * from './utils/response/pathRelativize.js';
-export * from './utils/response/structuredPagination.js';
 export type { GitHubPullRequestItem, Repository } from './github/githubAPI.js';
 export { isGitHubAPIError, isGitHubAPISuccess, isRepository, } from './github/githubAPI.js';
 export type { ProviderType, ProviderConfig, ProviderCapabilities, ProviderResponse, ICodeHostProvider, } from './providers/types.js';
@@ -161,27 +155,19 @@ export type { CodeSearchQuery, FileContentQuery, RepoSearchQuery, PullRequestQue
 export type { UnifiedRepository, CodeSearchItem, CodeSearchResult, FileContentResult, RepoSearchResult, PullRequestSearchResult, RepoStructureResult, } from './providers/types.js';
 export { isProviderSuccess, isProviderError } from './providers/types.js';
 export type { GitHubAPIError, GitHubAPISuccess, OptimizedCodeSearchResult, DiffEntry, PullRequestSimple, GitHubPullRequestsSearchParams, ContentDirectoryEntry, CodeSearchResultItem, RepoSearchResultItem, IssueSearchResultItem, IssueComment, PRReviewInfo, CommitFileInfo, CommitInfo, PRCommentItem, GetContentParameters, SearchCodeParameters, SearchCodeResponse, SearchReposParameters, GitHubAPIResponse, } from './github/githubAPI.js';
-export { HINTS, hasDynamicHints } from './hints/dynamic.js';
 export { summarizeEntries, paginateEntries, buildEntryPaginationHints, buildWalkWarnings, } from './tools/local_view_structure/structureResponse.js';
 export type { ExecResult } from './utils/core/types.js';
-export { getHints } from './hints/index.js';
-export { hints as ghSearchCodeHints } from './tools/github_search_code/hints.js';
-export { hints as githubFetchContentHints } from './tools/github_fetch_content/hints.js';
-export { hints as ghViewRepoStructureHints } from './tools/github_view_repo_structure/hints.js';
-export { hints as githubSearchReposHints } from './tools/github_search_repos/hints.js';
-export { hints as ghSearchPRsHints } from './tools/github_search_pull_requests/hints.js';
-export { hints as ghCloneRepoHints } from './tools/github_clone_repo/hints.js';
-export { hints as localRipgrepHints } from './tools/local_ripgrep/hints.js';
-export { hints as localViewStructureHints } from './tools/local_view_structure/hints.js';
-export { hints as localFindFilesHints } from './tools/local_find_files/hints.js';
-export { hints as localFetchContentHints } from './tools/local_fetch_content/hints.js';
-export { hints as lspSemanticContentHints } from './tools/lsp/semantic_content/hints.js';
-export { hints as npmSearchHints } from './tools/package_search/hints.js';
-export { getDynamicHints as getDynamicToolHints } from './hints/dynamic.js';
-export { securityRegistry, ContentSanitizer } from 'octocode-security';
-export { maskSensitiveData } from 'octocode-security/mask';
-export { configureSecurity } from 'octocode-security/withSecurityValidation';
-export { getOctocodeDir, paths, getDirectorySizeBytes, formatBytes, isWindows, isMac, HOME, getAppDataPath, storeCredentials, getCredentials, getCredentialsSync, deleteCredentials, isTokenExpired, isRefreshTokenExpired, getCredentialsFilePath, getEnvTokenSource, hasEnvToken, resolveTokenFull, refreshAuthToken, getTokenWithRefresh, getGhCliToken, } from 'octocode-shared';
-export type { OAuthToken, StoredCredentials } from 'octocode-shared';
+export { securityRegistry, ContentSanitizer, } from '@octocodeai/octocode-engine/security';
+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, ENV_TOKEN_VARS, getTokenFromEnv, getEnvTokenSource, hasEnvToken, getGhCliToken, } from './shared/credentials/index.js';
+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, } from './shared/config/index.js';
+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, CONFIG_FILE_PATH, loadConfig, loadConfigSync, configExists, getConfigPath, getOctocodeDir, validateConfig, getConfig, getConfigSync, reloadConfig, resolveConfig, resolveConfigSync, invalidateConfigCache, getConfigValue, _resetConfigCache, _getCacheState, OctocodeConfigSchema, } from './shared/config/index.js';
+export { OCTOCODE_HOME, getDefaultOctocodeHome, paths, ensureHome, ensureTmp, ensureClone, ensureRepos, ensureTree, ensureBinary, ensureUnzip, } from './shared/paths.js';
+export { getDirectorySizeBytes, formatBytes } from './shared/fs-utils.js';
 export { completeMetadata } from '@octocodeai/octocode-core';
 export { z } from 'zod';