@octocodeai/octocode-tools-core 18.2.0 → 19.1.0

package/dist/graph/fileImportLinker.d.ts

@@ -0,0 +1,28 @@
+import type { prepareMetadataImports } from './metadataImports.js';
+import type { prepareRustResolver } from './rustWorkspace.js';
+import type { WorkspacePackageExports } from './workspacePackageResolver.js';
+import type { PackageExportMode } from './packageExportTargets.js';
+import type { GraphCoverage, RawGraphFacts } from './types.js';
+/** One coverage policy for every source import, reexport, and module load. */
+export declare function createFileImportLinker(options: {
+    relativePath: string;
+    parsed: RawGraphFacts;
+    knownFiles: Set<string>;
+    getWorkspacePackageExports: () => WorkspacePackageExports;
+    metadata: ReturnType<typeof prepareMetadataImports>;
+    resolveRust: Awaited<ReturnType<typeof prepareRustResolver>>;
+    coverage: GraphCoverage;
+}): {
+    extension: string;
+    javascript: boolean;
+    python: boolean;
+    cFamily: boolean;
+    auxiliaryTargets: Set<string>;
+    resolve: (specifier: string, line: number, options?: {
+        moduleDeclaration?: boolean;
+        resolutionHint?: string;
+        moduleScope?: string[];
+        importedName?: string;
+        exportMode?: PackageExportMode;
+    }) => string | null;
+};

package/dist/graph/importResolver.d.ts

@@ -3,4 +3,4 @@
  * `knownFiles`, or `null` when it's external/bare or doesn't resolve within
  * the scanned set (dangling import, or a target outside the scan scope).
  */
-export declare function resolveImportSpecifier(specifier: string, importingFileRelativePath: string, knownFiles: ReadonlySet<string>, workspacePackageExports?: ReadonlyMap<string, string>): string | null;
+export declare function resolveImportSpecifier(specifier: string, importingFileRelativePath: string, knownFiles: ReadonlySet<string>): string | null;

package/dist/graph/languageImportResolver.d.ts

@@ -0,0 +1,5 @@
+import type { ImportResolution } from './types.js';
+/** Resolve exact syntax paths only; build-system search paths remain unsupported. */
+export declare function resolveCInclude(specifier: string, importer: string, hint: string | undefined, files: ReadonlySet<string>): ImportResolution;
+/** The selected root is a candidate Python import root, not a sys.path claim. */
+export declare function resolvePythonImport(specifier: string, importer: string, importedName: string | undefined, hint: string | undefined, files: ReadonlySet<string>): ImportResolution;

package/dist/graph/metadataImports.d.ts

@@ -0,0 +1,7 @@
+import type { ImportResolution } from './types.js';
+/** Only explicit package.json imports become leaves; never traverse their contents. */
+export declare function prepareMetadataImports(root: string, knownFiles: Set<string>, excludeDirs: readonly string[], maxFiles: number): {
+    targets: Set<string>;
+    resolve: (specifier: string, importer: string) => ImportResolution | undefined;
+    truncated: () => boolean;
+};

package/dist/graph/packageExportTargets.d.ts

@@ -0,0 +1,11 @@
+/** Syntax contexts, independent of the host process's own module format. */
+export type PackageExportMode = 'import' | 'require' | 'static' | 'types' | 'types-import' | 'types-require';
+type Selection = {
+    kind: 'target';
+    target: string;
+} | {
+    kind: 'unmatched' | 'blocked' | 'invalid' | 'unsupported';
+};
+/** Node export key order/pattern specificity, with explicit unknown-context gaps. */
+export declare function selectPackageExport(exports: unknown, subpath: string, mode: PackageExportMode): Selection;
+export {};

package/dist/graph/rustCargoMetadata.d.ts

@@ -0,0 +1,31 @@
+export interface RustCargoDependencyAlias {
+    alias: string;
+    packageName: string;
+    targetId?: string;
+    external: boolean;
+    conditional: boolean;
+}
+export interface RustCargoTarget {
+    id: string;
+    packageId: string;
+    packageName: string;
+    crateName: string;
+    kind: string[];
+    edition?: string;
+    srcPath: string;
+    dependencyAliases: RustCargoDependencyAlias[];
+}
+export interface RustCargoDiagnostic {
+    code: string;
+    message: string;
+}
+export interface RustCargoMetadataResult {
+    status: 'ok' | 'unsupported';
+    targets: RustCargoTarget[];
+    diagnostics: RustCargoDiagnostic[];
+}
+/** Called only by the explicit rustWorkspace:'cargo' graph mode. Never builds code. */
+export declare function resolveRustCargoMetadata(input: {
+    root: string;
+    files: readonly string[];
+}): Promise<RustCargoMetadataResult>;

package/dist/graph/rustCargoProcess.d.ts

@@ -0,0 +1,16 @@
+export declare const TIMEOUT_MS = 5000;
+export declare const MAX_BUFFER = 1048576;
+export declare class MetadataFailure extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function within(root: string, path: string): boolean;
+export declare function remaining(deadline: number): number;
+export declare function command(file: string, args: string[], cwd: string, env: NodeJS.ProcessEnv, deadline: number): Promise<string>;
+/** Use host PATH entries only; project rust-toolchain overrides never select the executable. */
+export declare function hostCargo(root: string, deadline: number): Promise<{
+    executable: string;
+    env: NodeJS.ProcessEnv;
+}>;
+/** Probe only ancestors of known Rust files, stopping at the supplied scan root. */
+export declare function manifests(root: string, files: readonly string[], deadline: number): Promise<string[]>;

package/dist/graph/rustModules.d.ts

@@ -0,0 +1,7 @@
+import type { ImportResolution, RawGraphFacts } from './types.js';
+export type RustDependencies = ReadonlyMap<string, ReadonlyMap<string, {
+    root?: string;
+    external: boolean;
+}>>;
+/** Build the logical module forest from declarations; physical neighbors are not modules. */
+export declare function createRustModuleResolver(facts: ReadonlyMap<string, RawGraphFacts>, files: ReadonlySet<string>, roots: readonly string[], dependencies?: RustDependencies, editions?: ReadonlyMap<string, string>): (specifier: string, file: string, scope?: string[], moduleDeclaration?: boolean, line?: number) => ImportResolution;

package/dist/graph/rustWorkspace.d.ts

@@ -0,0 +1,5 @@
+import type { RawGraphFacts, GraphCoverage } from './types.js';
+export declare function prepareRustResolver(rootAbsolutePath: string, knownFiles: ReadonlySet<string>, parsedEntries: Array<{
+    relativePath: string;
+    parsed: RawGraphFacts;
+}>, rustWorkspace: 'syntax' | 'cargo', coverage: GraphCoverage): Promise<(specifier: string, file: string, scope?: string[], moduleDeclaration?: boolean, line?: number) => import("./types.js").ImportResolution>;

package/dist/graph/types.d.ts

@@ -1,17 +1,58 @@
+export interface ImportResolution {
+    target: string | null;
+    status: 'resolved' | 'external' | 'unresolvedInternal' | 'unsupported';
+    additionalTargets?: string[];
+    /** Stable explanation for a bounded resolver's unavailable target or context. */
+    reason?: string;
+}
 export interface DeclarationFact {
+    /** Source occurrence identity; never a canonical cross-file symbol ID. */
     id: string;
     name: string;
     kind: string;
     line: number;
     exported: boolean;
 }
+export interface GraphCoverage {
+    /** Public response pagination; graph construction retains the full diagnostic list. */
+    diagnosticsPagination?: {
+        currentPage: number;
+        totalPages: number;
+        entriesPerPage: number;
+        totalEntries: number;
+        hasMore: boolean;
+        resultId: string;
+        outOfRange?: boolean;
+        terminalLimit?: boolean;
+    };
+    diagnosticCounts?: Record<string, number>;
+    basis: 'syntactic';
+    referenceBasis: 'lexical-occurrence';
+    languages: Array<{
+        language: string;
+        files: number;
+        linking: 'javascript-relative' | 'rust-modules' | 'python-modules' | 'c-relative-includes' | 'metadata' | 'unsupported';
+    }>;
+    imports: {
+        resolved: number;
+        external: number;
+        unresolvedInternal: number;
+        unsupported: number;
+    };
+    diagnostics: Array<{
+        file: string;
+        line?: number;
+        code: 'parse-recovery' | 'unsupported-linking' | 'unresolved-internal' | 'syntax-only';
+        message: string;
+    }>;
+}
 export interface ImportFact {
     specifier: string;
     localName: string;
     importedName: string;
     line: number;
-    /** Native syntax classification; `type` edges do not exist at runtime. */
-    importKind: 'type' | 'value';
+    /** Native syntax classification; `module` denotes a Rust module declaration. */
+    importKind: 'type' | 'value' | 'module';
     /**
      * Canonical target resolved during graph construction with the complete
      * workspace package-export map. `null` means the specifier is external or
@@ -64,4 +105,54 @@ export interface FileNode {
     /** Exact syntactic provenance for every resolved file edge. */
     edgeKinds: Map<string, Set<FileGraphEdgeKind>>;
 }
-export type FileGraphEdgeKind = 'static-import' | 'type-import' | 'dynamic-import' | 'named-reexport' | 'star-reexport';
+export type FileGraphEdgeKind = 'static-import' | 'type-import' | 'dynamic-import' | 'named-reexport' | 'star-reexport' | 'type-named-reexport' | 'type-star-reexport' | 'commonjs-require' | 'create-require' | 'metadata-import' | 'python-import' | 'rust-module' | 'rust-use' | 'c-include';
+export interface RawGraphFacts {
+    language?: string;
+    commonJs?: Array<{
+        specifier?: string;
+        line: number;
+        kind: 'commonjs-require';
+        binding: 'unshadowed-global' | 'create-require';
+        reason?: string;
+    }>;
+    diagnostics?: string[];
+    rustRootUnsupported?: boolean;
+    modules?: Array<{
+        name: string;
+        line: number;
+        scope: string[];
+        inline: boolean;
+        path?: string;
+        unsupported?: boolean;
+    }>;
+    declarations?: Array<{
+        id: string;
+        name: string;
+        kind: string;
+        line: number;
+        exported?: boolean;
+    }>;
+    imports?: Array<{
+        specifier: string;
+        localName: string;
+        importedName: string;
+        line: number;
+        importKind?: string;
+        resolutionHint?: string;
+        moduleScope?: string[];
+    }>;
+    calls?: Array<{
+        caller: string;
+        callee: string;
+        kind?: string;
+        line?: number;
+    }>;
+    exports?: Array<{
+        name: string;
+        line: number;
+        localName?: string;
+        exportKind?: string;
+        /** Present only for a re-export (`export ... from '...'`). */
+        source?: string;
+    }>;
+}

package/dist/graph/workspacePackageResolver.d.ts

@@ -1,2 +1,7 @@
-/** Resolve only exact package exports declared by manifests in this scan. */
-export declare function buildWorkspacePackageExports(rootAbsolutePath: string, knownFiles: ReadonlySet<string>): Map<string, string>;
+import { type PackageExportMode } from './packageExportTargets.js';
+import type { ImportResolution } from './types.js';
+export interface WorkspacePackageExports {
+    resolve(specifier: string, mode: PackageExportMode): ImportResolution | undefined;
+}
+/** Package export selection precedes bounded source projection and file existence checks. */
+export declare function buildWorkspacePackageExports(rootAbsolutePath: string, knownFiles: ReadonlySet<string>): WorkspacePackageExports;

package/dist/index.d.ts

@@ -3,24 +3,32 @@ export * from './config.js';
 export * from './errors/domainErrors.js';
 export * from './errors/errorFactories.js';
 export * from './errors/localToolErrors.js';
-export * from './errors/pathUtils.js';
+export { redactPath } from '@octocodeai/octocode-engine/pathUtils';
 export * from './errors/ToolError.js';
 export * from './github/client.js';
 export * from './github/codeSearch.js';
-export * from './github/directoryFetch.js';
+export { MAX_DIRECTORY_FILES, MAX_TOTAL_SIZE, } from './github/directoryFetch/helpers.js';
+export { fetchDirectoryContents } from './github/directoryFetch/fetchDirectoryContents.js';
+export { fetchFileContentToDisk } from './github/directoryFetch/fetchFileContentToDisk.js';
 export * from './github/errorConstants.js';
 export * from './github/errors.js';
 export * from './github/fileContent.js';
 export * from './github/fileContentProcess.js';
-export * from './github/fileContentRaw.js';
+export { applyContentPagination, fetchFileTimestamp, } from './github/fileContentPagination.js';
+export type { RawContentResult, RawContentFetchOptions, RawContentFetchResponse, } from './github/fileContentRaw/fetch.js';
+export { fetchRawGitHubFileContent } from './github/fileContentRaw/fetch.js';
 export * from './github/prByNumber.js';
-export * from './github/prContentFetcher.js';
+export { shouldEnrichPullRequestFromSearch } from './github/prContentFetcher/flags.js';
+export { transformPullRequestItemFromSearch, transformPullRequestItemFromREST, } from './github/prContentFetcher/transform.js';
 export * from './github/prTransformation.js';
 export * from './github/pullRequestSearch.js';
 export * from './github/history.js';
-export * from './github/queryBuilders.js';
+export { getOwnerQualifier } from './github/queryBuilders/base.js';
+export { buildCodeSearchQuery, buildRepoSearchQuery, } from './github/queryBuilders/codeAndRepo.js';
+export { buildPullRequestSearchQuery, shouldUseSearchForPRs, } from './github/queryBuilders/pullRequests.js';
+export { buildIssueSearchQuery, shouldUseSearchForIssues, type IssueSearchParams, } from './github/queryBuilders/issues.js';
 export * from './github/repoSearch.js';
-export * from './github/repoStructure.js';
+export { viewGitHubRepositoryStructureAPI } from './github/repoStructure/fetchOrchestration.js';
 export * from './github/repoStructurePagination.js';
 export * from './github/repoStructureRecursive.js';
 export * from './github/responseHeaders.js';
@@ -40,6 +48,8 @@ export * from './cacheMaintenance.js';
 export * from './session.js';
 export * from './tools/executionGuard.js';
 export * from './tools/github_clone_repo/cache.js';
+export { cleanupStaleMaterializationArtifacts, tryRecoverStaleCloneLock, writeCloneLockMeta, } from './tools/github_clone_repo/cacheArtifacts.js';
+export { getCloneBaseDir, getTreeBaseDir, getCloneDir, getTreeDir, } from './tools/github_clone_repo/cachePaths.js';
 export * from './tools/github_clone_repo/cloneRepo.js';
 export * from './tools/github_clone_repo/execution.js';
 export * from './tools/github_clone_repo/scheme.js';
@@ -66,25 +76,35 @@ export * from './tools/local_analyze_graph/scheme.js';
 export * from './tools/local_search/execution.js';
 export * from './tools/local_search/scheme.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';
 export * from './tools/lsp/shared/callHierarchyTraversal.js';
 export * from './tools/lsp/shared/resolveSymbolAnchor.js';
 export * from './tools/lsp/shared/semanticTypes.js';
 export * from './tools/package_search/execution.js';
+export { foldKeywords, isPackageNotFoundError, } from './tools/package_search/queryHelpers.js';
+export { buildPackagePagination } from './tools/package_search/pagination.js';
 export * from './tools/package_search/scheme.js';
 export * from './tools/providerExecution.js';
-export * from './tools/providerMappers.js';
+export * from './tools/providerMappers/codeSearch.js';
+export * from './tools/providerMappers/repoSearch.js';
+export * from './tools/providerMappers/pullRequests.js';
+export * from './tools/providerMappers/fileContent.js';
+export * from './tools/providerMappers/repoStructure.js';
 export * from './tools/toolConfig.js';
 export type { ToolConfig, ToolDirectExecutionConfig, ToolDirectSecurity, } from './tools/toolCatalogFactory.js';
-export * from './tools/toolMetadata/baseSchema.js';
-export * from './tools/toolMetadata/descriptions.js';
+export { baseSchemaDescriptions } from './toolContract/input/resources/global.js';
+export { PUBLIC_TOOL_DESCRIPTIONS } from './toolContract/descriptions.js';
 export * from './tools/toolMetadata/metadataPresence.js';
 export * from './tools/toolMetadata/names.js';
-export * from './tools/toolMetadata/proxies.js';
 export * from './tools/toolMetadata/state.js';
 export * from './tools/toolMetadata/types.js';
-export * from './tools/directToolCatalog.js';
+export * from './tools/directToolCatalog/toolCatalogDefinitions.js';
+export * from './tools/directToolCatalog/toolCatalogFormatters.js';
+export * from './tools/directToolCatalog/toolSchemaIntrospection.js';
+export * from './tools/directToolCatalog/toolCommandPatterns.js';
+export * from './tools/directToolCatalog/toolInputPreparation.js';
+export * from './tools/directToolCatalog/toolSchemaRelations.js';
+export { executeDirectTool } from './tools/directToolCatalog.exec.js';
 export * from './tools/toolNames.js';
 export * from './tools/utils.js';
 export * from './types/bulk.js';
@@ -103,16 +123,23 @@ export * from './utils/core/safeRegex.js';
 export * from './utils/environment/environmentDetection.js';
 export * from './utils/exec/npm.js';
 export * from './utils/exec/safe.js';
-export * from './utils/exec/spawn.js';
+export * from './utils/exec/spawn/env.js';
+export * from './utils/exec/spawn/wrappers.js';
 export * from './utils/file/byteOffset.js';
-export * from './utils/file/filters.js';
+export { DISCOVERY_IGNORED_FILE_EXTENSIONS, DISCOVERY_IGNORED_FILE_NAMES, DISCOVERY_IGNORED_FOLDER_NAMES, getDiscoveryExtension, shouldIgnoreDiscoveryDir, shouldIgnoreDiscoveryFile, } from '@octocodeai/octocode-engine/security';
+export type { DiscoveryExtensionOptions } from '@octocodeai/octocode-engine/security';
 export * from './utils/file/size.js';
 export * from './utils/file/toolHelpers.js';
-export * from './utils/http/cache.js';
+export * from './utils/http/cache/key.js';
+export * from './utils/http/cache/dataCache.js';
+export * from './utils/http/cache/conditional.js';
+export * from './utils/http/cache/management.js';
+export * from './utils/http/cache/diskStore.js';
 export * from './utils/http/circuitBreaker.js';
 export * from './utils/http/fetch.js';
 export * from './utils/package/common.js';
-export * from './utils/package/npm.js';
+export { getNpmRegistryUrl, checkNpmRegistryReachable, } from './utils/package/npm/npmRegistry.js';
+export { isExactPackageName, searchNpmPackage, checkNpmDeprecation, } from './utils/package/npm/npmDeprecation.js';
 export * from './utils/package/schemas.js';
 export * from './utils/package/types.js';
 export * from './utils/pagination/boundary.js';
@@ -122,7 +149,8 @@ export * from './utils/pagination/hints.js';
 export * from './utils/pagination/types.js';
 export * from './utils/parsers/diff.js';
 export * from './utils/parsers/schemas.js';
-export * from './utils/response/bulk.js';
+export { computeQueryTimeout } from './utils/response/bulk/queries.js';
+export { executeBulkOperation } from './utils/response/bulk/response.js';
 export * from './utils/response/callToolResult.js';
 export * from './utils/response/normalizedError.js';
 export * from './utils/response/charSavings.js';
@@ -132,8 +160,7 @@ export * from './utils/response/pathRelativize.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';
-export type { CodeSearchQuery, FileContentQuery, RepoSearchQuery, PullRequestQuery, RepoStructureQuery, } from './providers/types.js';
-export type { UnifiedRepository, CodeSearchItem, CodeSearchResult, FileContentResult, RepoSearchResult, PullRequestSearchResult, RepoStructureResult, } from './providers/types.js';
+export type { UnifiedRepository, CodeSearchItem, CodeSearchResult, FileContentResult, RepoSearchResult, PullRequestSearchResult, RepoStructureResult, } from './providers/providerResults.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 { summarizeEntries, paginateEntries, buildEntryPaginationHints, buildWalkWarnings, } from './tools/local_view_structure/structureResponse.js';