@octocodeai/octocode-tools-core 16.6.3 → 17.0.2

package/dist/tools/providerMappers/repoSearch.d.ts

@@ -0,0 +1,30 @@
+import type { RepoSearchResult as ProviderRepoSearchResult } from '../../providers/types.js';
+import type { z } from 'zod';
+import type { GitHubReposSearchSingleQuerySchema } from '@octocodeai/octocode-core/schemas';
+import type { GitHubRepositoryOutput } from '@octocodeai/octocode-core/extra-types';
+import type { WithOptionalMeta } from '../../types/execution.js';
+type GitHubReposSearchSingleQuery = z.infer<typeof GitHubReposSearchSingleQuerySchema>;
+export declare function mapRepoSearchToolQuery(query: WithOptionalMeta<GitHubReposSearchSingleQuery>): {
+    keywords: string[];
+    topics: string[];
+    owner: string;
+    stars: string;
+    size: string;
+    created: string;
+    updated: string;
+    language: string;
+    archived: boolean | undefined;
+    visibility: "public" | "private" | undefined;
+    forks: string | undefined;
+    license: string | undefined;
+    goodFirstIssues: string | undefined;
+    match: ("description" | "name" | "readme")[];
+    sort: "stars" | "forks" | "updated" | "created" | "best-match" | undefined;
+    limit: number | undefined;
+    page: number;
+    mainResearchGoal: string;
+    researchGoal: string;
+    reasoning: string;
+};
+export declare function mapRepoSearchProviderRepositories(repositories: ProviderRepoSearchResult['repositories']): GitHubRepositoryOutput[];
+export {};

package/dist/tools/providerMappers/repoStructure.d.ts

@@ -0,0 +1,20 @@
+import type { RepoStructureResult as ProviderRepoStructureResult } from '../../providers/types.js';
+import type { z } from 'zod';
+import type { GitHubViewRepoStructureQuerySchema } from '@octocodeai/octocode-core/schemas';
+import type { WithOptionalMeta } from '../../types/execution.js';
+type GitHubViewRepoStructureQuery = z.infer<typeof GitHubViewRepoStructureQuerySchema>;
+type PartialRepoStructureQuery = WithOptionalMeta<GitHubViewRepoStructureQuery>;
+export declare function mapRepoStructureToolQuery(query: PartialRepoStructureQuery, resolvedBranch: string): {
+    projectId: string;
+    ref: string;
+    path: string;
+    depth: number;
+    itemsPerPage: number;
+    page: number;
+    includeSizes: boolean;
+    mainResearchGoal: string;
+    researchGoal: string;
+    reasoning: string;
+};
+export declare function mapRepoStructureProviderResult(data: ProviderRepoStructureResult, _query: PartialRepoStructureQuery, filteredStructure: ProviderRepoStructureResult['structure'], resolvedBranch: string): Record<string, unknown>;
+export {};

package/dist/tools/providerMappers/shared.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Small helpers shared across the providerMappers/* domain files.
+ * Kept internal to the providerMappers module (not part of its public
+ * barrel contract) — imported directly by sibling files in this directory.
+ */
+export declare function toProviderProjectId(owner?: string, repo?: string): string | undefined;
+export declare function splitRepositoryPath(repositoryPath: string): {
+    owner: string;
+    repo: string;
+};
+export declare function countMetadata(pagination: {
+    reportedTotalMatches?: number;
+    reachableTotalMatches?: number;
+    totalMatchesKind?: 'exact' | 'reported' | 'lowerBound';
+    totalMatchesCapped?: boolean;
+    uniqueFileCount?: number;
+} | undefined): {
+    uniqueFileCount?: number;
+    totalMatchesCapped?: boolean;
+    totalMatchesKind?: "exact" | "reported" | "lowerBound";
+    reachableTotalMatches?: number;
+    reportedTotalMatches?: number;
+};

package/dist/tools/providerMappers.d.ts

@@ -1,296 +1,11 @@
-import type { CodeSearchResult, FileContentResult as ProviderFileContentResult, PullRequestSearchResult as ProviderPullRequestSearchResult, RepoSearchResult as ProviderRepoSearchResult, RepoStructureResult as ProviderRepoStructureResult } from '../providers/types.js';
-import type { z } from 'zod';
-import type { GitHubCodeSearchQuerySchema, GitHubReposSearchSingleQuerySchema, GitHubViewRepoStructureQuerySchema } from '@octocodeai/octocode-core/schemas';
-import type { GitHubPullRequestSearchQueryLocalSchema } from './github_search_pull_requests/scheme.js';
-import type { GitHubRepositoryOutput } from '@octocodeai/octocode-core/extra-types';
-import type { WithOptionalMeta } from '../types/execution.js';
-import { FileContentQueryLocalSchema } from './github_fetch_content/scheme.js';
-type GitHubCodeSearchQuery = z.infer<typeof GitHubCodeSearchQuerySchema>;
-type LocalFileContentQuery = z.infer<typeof FileContentQueryLocalSchema> & {
-    minify: import('../scheme/fields.js').MinifyMode;
-};
 /**
- * Char-boundary truncation mirroring the Rust engine's `truncate_unicode`:
- * keeps at most `maxChars` Unicode scalars and appends `...` when it cuts.
- * Never slices UTF-8 mid-codepoint or mid-token — the single data-layer bound
- * for GitHub code-search match fragments (the render layer must not re-trim).
+ * Barrel re-exporting the provider<->tool mapping helpers, split by domain
+ * under ./providerMappers/*. Kept as a thin re-export so existing imports
+ * from '../providerMappers.js' (and `export *` from src/index.ts) continue
+ * to resolve without any consumer changes.
  */
-export declare function truncateSnippetChars(value: string, maxChars?: number): string;
-type GitHubPullRequestSearchQuery = z.infer<typeof GitHubPullRequestSearchQueryLocalSchema>;
-type GitHubReposSearchSingleQuery = z.infer<typeof GitHubReposSearchSingleQuerySchema>;
-type GitHubViewRepoStructureQuery = z.infer<typeof GitHubViewRepoStructureQuerySchema>;
-type PRDefaultKeys = 'order' | 'limit' | 'page';
-type PartialPRQuery = WithOptionalMeta<Omit<GitHubPullRequestSearchQuery, PRDefaultKeys> & Partial<Pick<GitHubPullRequestSearchQuery, PRDefaultKeys>>>;
-type PartialRepoStructureQuery = WithOptionalMeta<GitHubViewRepoStructureQuery>;
-export declare function buildPaginationHints(pagination: {
-    currentPage: number;
-    totalPages: number;
-    hasMore: boolean;
-    entriesPerPage?: number;
-    perPage?: number;
-    totalMatches?: number;
-    reportedTotalMatches?: number;
-    reachableTotalMatches?: number;
-    totalMatchesKind?: 'exact' | 'reported' | 'lowerBound';
-    totalMatchesCapped?: boolean;
-}, label: string): string[];
-export declare function mapCodeSearchToolQuery(query: WithOptionalMeta<GitHubCodeSearchQuery>): {
-    keywords: string[];
-    projectId: string;
-    owner: string;
-    path: string;
-    filename: string;
-    extension: string;
-    language: string | undefined;
-    match: "file" | "path";
-    limit: number | undefined;
-    page: number;
-    mainResearchGoal: string;
-    researchGoal: string;
-    reasoning: string;
-};
-export interface CodeSearchGroupedMatch {
-    path: string;
-    value?: string;
-    pathOnly?: boolean;
-    matchIndices?: Array<{
-        start: number;
-        end: number;
-        lineOffset: number;
-    }>;
-    url?: string;
-}
-export interface CodeSearchGroupedResult {
-    id: string;
-    queryId?: string;
-    owner: string;
-    repo: string;
-    matches: CodeSearchGroupedMatch[];
-}
-export interface CodeSearchPagination {
-    currentPage: number;
-    totalPages: number;
-    perPage: number;
-    totalMatches: number;
-    reportedTotalMatches?: number;
-    reachableTotalMatches?: number;
-    totalMatchesKind?: 'exact' | 'reported' | 'lowerBound';
-    totalMatchesCapped?: boolean;
-    hasMore: boolean;
-    nextPage?: number;
-    uniqueFileCount?: number;
-}
-export interface CodeSearchFlatResult {
-    results: CodeSearchGroupedResult[];
-    pagination?: CodeSearchPagination;
-    nonExistentScope?: boolean;
-    incompleteResults?: boolean;
-}
-export declare function mapCodeSearchProviderResult(data: CodeSearchResult, query: WithOptionalMeta<GitHubCodeSearchQuery>): CodeSearchFlatResult;
-export declare function mapRepoSearchToolQuery(query: WithOptionalMeta<GitHubReposSearchSingleQuery>): {
-    keywords: string[];
-    topics: string[];
-    owner: string;
-    stars: string;
-    size: string;
-    created: string;
-    updated: string;
-    language: string;
-    archived: boolean | undefined;
-    visibility: "public" | "private" | undefined;
-    forks: string | undefined;
-    license: string | undefined;
-    goodFirstIssues: string | undefined;
-    match: ("description" | "name" | "readme")[];
-    sort: "stars" | "forks" | "updated" | "created" | "best-match" | undefined;
-    limit: number | undefined;
-    page: number;
-    mainResearchGoal: string;
-    researchGoal: string;
-    reasoning: string;
-};
-export declare function mapRepoSearchProviderRepositories(repositories: ProviderRepoSearchResult['repositories']): GitHubRepositoryOutput[];
-export declare function mapPullRequestToolQuery(query: PartialPRQuery): {
-    projectId: string;
-    owner: string;
-    query: string;
-    number: number;
-    state: "open" | "closed" | "merged" | "all" | undefined;
-    author: string;
-    assignee: string;
-    commenter: string;
-    involves: string;
-    mentions: string;
-    reviewRequested: string;
-    reviewedBy: string;
-    labels: string[];
-    noLabel: boolean;
-    noMilestone: boolean;
-    noProject: boolean;
-    noAssignee: boolean;
-    baseBranch: string;
-    headBranch: string;
-    created: string;
-    updated: string;
-    closed: string;
-    mergedAt: string;
-    comments: string;
-    reactions: string;
-    interactions: string;
-    draft: boolean;
-    match: ("title" | "comments" | "body")[];
-    milestone: string;
-    language: string;
-    checks: "success" | "failure" | "pending";
-    review: "none" | "approved" | "changes_requested" | "required";
-    locked: boolean;
-    visibility: "public" | "private";
-    teamMentions: string;
-    project: string;
-    archived: boolean | undefined;
-    content: unknown;
-    reviewMode: "full" | "summary";
-    filePage: number;
-    commentPage: number;
-    commitPage: number;
-    itemsPerPage: number;
-    sort: "created" | "updated" | "best-match" | "comments" | "reactions" | undefined;
-    order: "asc" | "desc" | undefined;
-    limit: number;
-    page: number;
-    charOffset: number;
-    charLength: number;
-    mainResearchGoal: string;
-    researchGoal: string;
-    reasoning: string;
-};
-export declare function mapPullRequestProviderResultData(data: ProviderPullRequestSearchResult, options?: {
-    includeFileChanges?: boolean;
-}): {
-    pullRequests: {
-        sanitizationWarnings?: string[];
-        fileChanges?: {
-            path: string;
-            status: string;
-            additions: number;
-            deletions: number;
-            patch?: string;
-        }[];
-        reviewSummary: {
-            totalComments: number;
-            inlineComments: number;
-            discussionComments: number;
-            commenters: string[];
-            latestCommentAt?: string;
-            themes: string[];
-        };
-        commits: {
-            sha: string;
-            message: string;
-            author: string;
-            date: string;
-        }[];
-        reviews: {
-            id: string;
-            user: string;
-            state: string;
-            body: string;
-            submittedAt?: string;
-            commitId?: string;
-        }[];
-        comments: {
-            bodyPagination: {
-                charOffset: number;
-                charLength: number;
-                totalChars: number;
-                hasMore: boolean;
-                nextCharOffset?: number;
-            };
-            id: string;
-            author: string;
-            body: string;
-            createdAt: string;
-            updatedAt: string;
-            commentType?: "discussion" | "review_inline";
-            path?: string;
-            line?: number;
-            in_reply_to_id?: number;
-        }[];
-        url: string;
-        state: "open" | "closed" | "merged";
-        draft: boolean;
-        author: string;
-        assignees: string[];
-        labels: string[];
-        sourceBranch: string;
-        targetBranch: string;
-        sourceSha: string;
-        targetSha: string;
-        createdAt: string;
-        updatedAt: string;
-        closedAt: string;
-        mergedAt: string;
-        commentsCount: number;
-        changedFilesCount: number;
-        additions: number;
-        deletions: number;
-        bodyPagination: {
-            charOffset: number;
-            charLength: number;
-            totalChars: number;
-            hasMore: boolean;
-            nextCharOffset?: number;
-        };
-        number: number;
-        title: string;
-        body: string;
-    }[];
-    resultData: Record<string, unknown>;
-    pagination: {
-        nextPage?: number;
-        hasMore: boolean;
-        uniqueFileCount?: number;
-        totalMatchesCapped?: boolean;
-        totalMatchesKind?: "exact" | "reported" | "lowerBound";
-        reachableTotalMatches?: number;
-        reportedTotalMatches?: number;
-        totalMatches?: number;
-        currentPage: number;
-        totalPages: number;
-        perPage: number;
-    };
-};
-export declare function mapFileContentToolQuery(query: LocalFileContentQuery): {
-    projectId: string;
-    path: string;
-    ref: string;
-    startLine: number;
-    endLine: number;
-    matchString: string;
-    contextLines: number;
-    fullContent: boolean;
-    forceRefresh: boolean;
-    charOffset: number;
-    charLength: number;
-    minify: "none" | "standard" | "symbols";
-    matchStringIsRegex: boolean;
-    matchStringCaseSensitive: boolean;
-    mainResearchGoal: string;
-    researchGoal: string;
-    reasoning: string;
-};
-export declare function mapFileContentProviderResult(data: ProviderFileContentResult, query: WithOptionalMeta<LocalFileContentQuery>): Record<string, unknown>;
-export declare function mapRepoStructureToolQuery(query: PartialRepoStructureQuery, resolvedBranch: string): {
-    projectId: string;
-    ref: string;
-    path: string;
-    depth: number;
-    itemsPerPage: number;
-    page: number;
-    includeSizes: boolean;
-    mainResearchGoal: string;
-    researchGoal: string;
-    reasoning: string;
-};
-export declare function mapRepoStructureProviderResult(data: ProviderRepoStructureResult, _query: PartialRepoStructureQuery, filteredStructure: ProviderRepoStructureResult['structure'], resolvedBranch: string): Record<string, unknown>;
-export {};
+export * from './providerMappers/codeSearch.js';
+export * from './providerMappers/repoSearch.js';
+export * from './providerMappers/pullRequests.js';
+export * from './providerMappers/fileContent.js';
+export * from './providerMappers/repoStructure.js';

package/dist/tools/toolConfig.d.ts

@@ -19,7 +19,6 @@ export interface ToolConfig {
     isDefault: boolean;
     isLocal: boolean;
     isClone?: boolean;
-    isBinary?: boolean;
     type: 'search' | 'content' | 'history' | 'debug';
     skipMetadataCheck?: boolean;
     direct: ToolDirectExecutionConfig;
@@ -37,6 +36,5 @@ export declare const LOCAL_VIEW_STRUCTURE: ToolConfig;
 export declare const LOCAL_FIND_FILES: ToolConfig;
 export declare const LOCAL_FETCH_CONTENT: ToolConfig;
 export declare const LSP_GET_SEMANTIC_CONTENT: ToolConfig;
-export declare const LOCAL_BINARY_INSPECT: ToolConfig;
 export declare const OQL_SEARCH: ToolConfig;
 export declare const ALL_TOOLS: ToolConfig[];

package/dist/tools/toolMetadata/descriptionOverrides.d.ts

@@ -0,0 +1,4 @@
+import type { CompleteMetadata } from '@octocodeai/octocode-core/types';
+export declare function getPatchedToolMetadata(source?: CompleteMetadata): CompleteMetadata;
+/** Test helper — clear memoization between cases. */
+export declare function _resetDescriptionOverrideCache(): void;

package/dist/tools/toolSchemaImports.d.ts

@@ -0,0 +1,13 @@
+export { CloneRepoQueryLocalSchema, BulkCloneRepoLocalSchema, } from './github_clone_repo/scheme.js';
+export { FileContentQueryLocalSchema, FileContentBulkQueryLocalSchema, } from './github_fetch_content/scheme.js';
+export { GitHubCodeSearchQueryLocalSchema, GitHubCodeSearchBulkQueryLocalSchema, } from './github_search_code/scheme.js';
+export { GitHubPullRequestSearchQueryLocalSchema, GitHubPullRequestSearchBulkQueryLocalSchema, } from './github_search_pull_requests/scheme.js';
+export { GitHubReposSearchSingleQueryLocalSchema, GitHubReposSearchBulkQueryLocalSchema, } from './github_search_repos/scheme.js';
+export { GitHubViewRepoStructureQueryLocalSchema, GitHubViewRepoStructureBulkQueryLocalSchema, } from './github_view_repo_structure/scheme.js';
+export { NpmSearchQueryLocalSchema, NpmSearchBulkQueryLocalSchema, } from './package_search/scheme.js';
+export { LocalFetchContentQuerySchema, LocalFetchContentBulkQuerySchema, } from './local_fetch_content/scheme.js';
+export { LocalFindFilesQuerySchema, LocalFindFilesBulkQuerySchema, } from './local_find_files/scheme.js';
+export { LocalRipgrepQuerySchema, LocalRipgrepBulkQuerySchema, } from './local_ripgrep/scheme.js';
+export { LocalViewStructureQuerySchema, LocalViewStructureBulkQuerySchema, } from './local_view_structure/scheme.js';
+export { BulkLspGetSemanticsQuerySchema, LspGetSemanticsQueryDisplaySchema, } from './lsp/semantic_content/scheme.js';
+export { OqlDisplayQuerySchema as OqlSearchQuerySchema, OqlSearchInputSchema, } from '../oql/schema.js';

package/dist/utils/contextUtils.d.ts

@@ -1,5 +1,5 @@
 import type * as NativeContextUtils from '@octocodeai/octocode-engine';
-export type { BinaryInspectInfo, BinaryStrings, ExtractMatchingLinesOptions, ExtractMatchingLinesResult, FilterPatchOptions, FileSystemEntry, FileSystemQueryOptions, FileSystemQueryResult, GraphFactCapability, GraphFactCall, GraphFactDeclaration, GraphFactEdge, GraphFactExport, GraphFactImport, GraphFacts, MinifyResult, JsonInput, RipgrepParseOptions, RipgrepParseResult, RipgrepSearchOptions, SliceContentOptions, SliceContentResult, StructuralMatch, YamlConversionConfig, } from '@octocodeai/octocode-engine';
+export type { ExtractMatchingLinesOptions, ExtractMatchingLinesResult, FilterPatchOptions, FileSystemEntry, FileSystemQueryOptions, FileSystemQueryResult, GraphFactCapability, GraphFactCall, GraphFactDeclaration, GraphFactEdge, GraphFactExport, GraphFactImport, GraphFacts, LineDiffOp, MinifyResult, JsonInput, RipgrepParseOptions, RipgrepParseResult, RipgrepSearchOptions, SliceContentOptions, SliceContentResult, StructuralMatch, YamlConversionConfig, } from '@octocodeai/octocode-engine';
 type NativeContextUtilsModule = typeof NativeContextUtils;
 type NativeLoader = () => NativeContextUtilsModule;
 export declare class ContextUtilsLoadError extends Error {
@@ -47,29 +47,18 @@ export declare const contextUtils: {
      * Native graph-fact capability matrix as a JSON `GraphFactCapability[]`.
      */
     getGraphFactCapabilities(): string;
-    structuralSearch(content: string, filePath: string, pattern?: string | null, rule?: string | null): NativeContextUtils.StructuralMatch[];
-    structuralSearchFiles(options: NativeContextUtils.StructuralSearchFilesOptions): NativeContextUtils.StructuralSearchFilesResult;
+    structuralSearch(content: string, filePath: string, pattern?: string | null, rule?: string | null): Promise<NativeContextUtils.StructuralMatch[]>;
+    structuralSearchFiles(options: NativeContextUtils.StructuralSearchFilesOptions): Promise<NativeContextUtils.StructuralSearchFilesResult>;
     getSupportedStructuralExtensions(): string[];
-    /**
-     * Native binary inspection (format lane). Parses an executable / object /
-     * archive and returns identity + symbols/imports/exports/sections/deps.
-     * Degrades to magic-byte identity on malformed input; only unreadable or
-     * oversized files throw.
-     */
-    inspectBinaryNative(path: string): NativeContextUtils.BinaryInspectInfo;
-    /**
-     * Native strings extraction — printable ASCII + UTF-16 (LE/BE) runs of at
-     * least `minLength`, longest-first, optionally hex offset-prefixed.
-     */
-    extractBinaryStringsNative(path: string, minLength: number, includeOffsets: boolean, scanOffset?: number): NativeContextUtils.BinaryStrings;
     validateRipgrepPattern(pattern: string, fixedString?: boolean | null, perlRegex?: boolean | null): NativeContextUtils.RipgrepPatternValidationResult;
-    getSemanticBoundaryOffsets(content: string, filePath: string): number[];
+    getSemanticBoundaryOffsets(content: string, filePath: string): Promise<number[]>;
     jsonToYamlString(jsonObject: NativeContextUtils.JsonInput, config?: NativeContextUtils.YamlConversionConfig | null): string;
     parseRipgrepJson(stdout: string, options?: NativeContextUtils.RipgrepParseOptions | null): NativeContextUtils.RipgrepParseResult;
     searchRipgrep(options: NativeContextUtils.RipgrepSearchOptions): Promise<NativeContextUtils.RipgrepParseResult>;
     queryFileSystem(options: NativeContextUtils.FileSystemQueryOptions): NativeContextUtils.FileSystemQueryResult;
     extractMatchingLines(content: string, pattern: string, options?: NativeContextUtils.ExtractMatchingLinesOptions | null): NativeContextUtils.ExtractMatchingLinesResult;
     filterPatch(patch: string, options?: NativeContextUtils.FilterPatchOptions | null): string;
+    computeLineDiff(oldText: string, newText: string): NativeContextUtils.LineDiffOp[];
     charToByteOffset(content: string, charIndex: number): number;
     byteToCharOffset(content: string, byteOffset: number): number;
     byteSliceContent(content: string, byteStart: number, byteEnd: number): string;

package/dist/utils/core/types.d.ts

@@ -19,30 +19,8 @@ export interface ExecOptions {
      */
     tolerateOutputLimit?: boolean;
 }
-export interface PaginationInfo {
-    currentPage: number;
-    totalPages: number;
-    hasMore: boolean;
-    nextPage?: number;
-    nextMatchPage?: number;
-    charOffset?: number;
-    charLength?: number;
-    totalChars?: number;
-    chunkMode?: 'semantic' | 'char-limit';
-    nextBlockChar?: number;
-    perPage?: number;
-    itemsPerPage?: number;
-    filesPerPage?: number;
-    totalFiles?: number;
-    entriesPerPage?: number;
-    totalEntries?: number;
-    matchesPerPage?: number;
-    totalMatches?: number;
-    reportedTotalMatches?: number;
-    reachableTotalMatches?: number;
-    totalMatchesKind?: 'exact' | 'reported' | 'lowerBound';
-    totalMatchesCapped?: boolean;
-}
+/** Canonical pagination type — single source in types/toolResults.ts. */
+export type { PaginationInfo } from '../../types/toolResults.js';
 export interface SearchStats {
     totalOccurrences?: number;
     totalStructuralMatches?: number;

package/dist/utils/exec/spawn/env.d.ts

@@ -0,0 +1,5 @@
+export declare const SENSITIVE_ENV_VARS: readonly ["NODE_OPTIONS", "GITHUB_TOKEN", "GH_TOKEN", "OCTOCODE_TOKEN", "GITHUB_PERSONAL_ACCESS_TOKEN", "NPM_TOKEN", "AWS_SECRET_ACCESS_KEY", "AWS_SESSION_TOKEN"];
+export declare const CORE_ALLOWED_ENV_VARS: readonly ["PATH", "TMPDIR", "TMP", "TEMP", "SYSTEMROOT", "WINDIR", "COMSPEC", "PATHEXT"];
+export declare const TOOLING_ALLOWED_ENV_VARS: readonly ["PATH", "TMPDIR", "TMP", "TEMP", "SYSTEMROOT", "WINDIR", "COMSPEC", "PATHEXT", "HOME", "USERPROFILE", "APPDATA", "LOCALAPPDATA"];
+export declare const PROXY_ENV_VARS: readonly ["HTTP_PROXY", "HTTPS_PROXY", "NO_PROXY", "http_proxy", "https_proxy", "no_proxy"];
+export declare function buildChildProcessEnv(envOverrides?: Record<string, string | undefined>, allowEnvVars?: readonly string[]): typeof process.env;

package/dist/utils/exec/spawn/wrappers.d.ts

@@ -0,0 +1,29 @@
+interface SpawnWithTimeoutOptions {
+    timeout?: number;
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+    allowEnvVars?: readonly string[];
+    maxOutputSize?: number;
+}
+interface SpawnResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    success: boolean;
+    error?: Error;
+    timedOut?: boolean;
+    outputLimitExceeded?: boolean;
+}
+export declare function spawnWithTimeout(command: string, args: string[], options?: SpawnWithTimeoutOptions): Promise<SpawnResult>;
+export declare function spawnCheckSuccess(command: string, args: string[], timeoutMs?: number, options?: {
+    allowEnvVars?: readonly string[];
+}): Promise<boolean>;
+export declare function spawnCollectStdout(command: string, args: string[], timeoutMs?: number, options?: {
+    allowEnvVars?: readonly string[];
+    maxOutputSize?: number;
+}): Promise<string | null>;
+export declare function validateArgs(args: string[], maxLength?: number): {
+    valid: boolean;
+    error?: string;
+};
+export {};

package/dist/utils/exec/spawn.d.ts

@@ -1,34 +1,2 @@
-interface SpawnWithTimeoutOptions {
-    timeout?: number;
-    cwd?: string;
-    env?: Record<string, string | undefined>;
-    allowEnvVars?: readonly string[];
-    maxOutputSize?: number;
-}
-export declare const SENSITIVE_ENV_VARS: readonly ["NODE_OPTIONS", "GITHUB_TOKEN", "GH_TOKEN", "OCTOCODE_TOKEN", "GITHUB_PERSONAL_ACCESS_TOKEN", "NPM_TOKEN", "AWS_SECRET_ACCESS_KEY", "AWS_SESSION_TOKEN"];
-export declare const CORE_ALLOWED_ENV_VARS: readonly ["PATH", "TMPDIR", "TMP", "TEMP", "SYSTEMROOT", "WINDIR", "COMSPEC", "PATHEXT"];
-export declare const TOOLING_ALLOWED_ENV_VARS: readonly ["PATH", "TMPDIR", "TMP", "TEMP", "SYSTEMROOT", "WINDIR", "COMSPEC", "PATHEXT", "HOME", "USERPROFILE", "APPDATA", "LOCALAPPDATA"];
-export declare const PROXY_ENV_VARS: readonly ["HTTP_PROXY", "HTTPS_PROXY", "NO_PROXY", "http_proxy", "https_proxy", "no_proxy"];
-export declare function buildChildProcessEnv(envOverrides?: Record<string, string | undefined>, allowEnvVars?: readonly string[]): typeof process.env;
-interface SpawnResult {
-    stdout: string;
-    stderr: string;
-    exitCode: number | null;
-    success: boolean;
-    error?: Error;
-    timedOut?: boolean;
-    outputLimitExceeded?: boolean;
-}
-export declare function spawnWithTimeout(command: string, args: string[], options?: SpawnWithTimeoutOptions): Promise<SpawnResult>;
-export declare function spawnCheckSuccess(command: string, args: string[], timeoutMs?: number, options?: {
-    allowEnvVars?: readonly string[];
-}): Promise<boolean>;
-export declare function spawnCollectStdout(command: string, args: string[], timeoutMs?: number, options?: {
-    allowEnvVars?: readonly string[];
-    maxOutputSize?: number;
-}): Promise<string | null>;
-export declare function validateArgs(args: string[], maxLength?: number): {
-    valid: boolean;
-    error?: string;
-};
-export {};
+export * from './spawn/env.js';
+export * from './spawn/wrappers.js';

package/dist/utils/file/toolHelpers.d.ts

@@ -12,6 +12,18 @@ type ToolPathValidationResult = {
     sanitizedPath: string;
     errorResult?: undefined;
 };
+/**
+ * Apply `.octocoderc` `local.allowedPaths` to the shared PathValidator so the
+ * file-config allowlist behaves identically to the `ALLOWED_PATHS` env var
+ * (which the PathValidator reads directly at construction). Without this, a
+ * user setting `allowedPaths` in `.octocoderc` gets a silent no-op — the field
+ * is validated by the config layer but never reaches the validator.
+ *
+ * `addAllowedRoot` de-duplicates and expands `~`, so this is idempotent and
+ * cheap to call per request (the common case is an empty array — a no-op).
+ * Exported for testing.
+ */
+export declare function applyConfiguredAllowedRoots(allowedPaths?: readonly string[]): void;
 export declare function validateToolPath(query: PartialBaseQueryLocal & {
     path?: string;
 }, toolName: string): ToolPathValidationResult;

package/dist/utils/http/cache/conditional.d.ts

@@ -0,0 +1,21 @@
+import NodeCache from 'node-cache';
+/**
+ * Soft ETag store: survives primary TTL so a miss can send If-None-Match and
+ * recover a 304 without paying a full body download (GitHub authorized 304s
+ * do not burn primary rate-limit quota).
+ */
+export declare const etagSoftCache: NodeCache;
+export type ConditionalFetchResult<T> = {
+    value: T;
+    etag?: string;
+    /** True when the upstream responded 304 Not Modified. */
+    notModified?: boolean;
+};
+export declare function withDataCacheConditional<T>(cacheKey: string, operation: (opts: {
+    ifNoneMatch?: string;
+}) => Promise<ConditionalFetchResult<T>>, options?: {
+    ttl?: number;
+    skipCache?: boolean;
+    forceRefresh?: boolean;
+    shouldCache?: (value: T) => boolean;
+}): Promise<T>;

package/dist/utils/http/cache/dataCache.d.ts

@@ -0,0 +1,6 @@
+export declare function withDataCache<T>(cacheKey: string, operation: () => Promise<T>, options?: {
+    ttl?: number;
+    skipCache?: boolean;
+    forceRefresh?: boolean;
+    shouldCache?: (value: T) => boolean;
+}): Promise<T>;

package/dist/utils/http/cache/key.d.ts

@@ -0,0 +1 @@
+export declare function generateCacheKey(prefix: string, params: unknown, sessionId?: string): string;

package/dist/utils/http/cache/management.d.ts

@@ -0,0 +1,9 @@
+import type { CacheStats } from '../../core/types.js';
+export declare function clearAllCache(): void;
+export declare function clearLocalToolCache(): number;
+export declare function clearLSPToolCache(): number;
+export declare function clearRemoteAPICache(): number;
+export declare function getCacheStats(): CacheStats & {
+    hitRate: number;
+    cacheSize: number;
+};

package/dist/utils/http/cache/store.d.ts

@@ -0,0 +1,28 @@
+import NodeCache from 'node-cache';
+import type { CacheStats } from '../../core/types.js';
+export declare const PENDING_REQUEST_MAX_AGE_MS: number;
+export declare const cache: NodeCache;
+export declare const cacheStats: CacheStats;
+export declare const CACHE_TTL_CONFIG: {
+    readonly 'gh-api-code': 3600;
+    readonly 'gh-api-repos': 7200;
+    readonly 'gh-api-prs': 1800;
+    readonly 'gh-api-issues': 1800;
+    readonly 'gh-api-history': 1800;
+    readonly 'gh-api-releases': 3600;
+    readonly 'gh-api-file-content': 300;
+    readonly 'gh-repo-structure-api': 7200;
+    readonly 'github-user': 900;
+    readonly 'npm-search': 14400;
+    readonly default: 86400;
+};
+export interface PendingRequest {
+    promise: Promise<unknown>;
+    startedAt: number;
+}
+export declare const pendingRequests: Map<string, PendingRequest>;
+export declare function extractCachePrefix(cacheKey: string): string | undefined;
+export declare function recordGitHubCacheHit(cacheKey: string): void;
+export declare function cleanupStalePendingRequests(): void;
+export declare function getTTLForPrefix(prefix: string): number;
+export declare function safeCacheSet(key: string, value: unknown, ttl: number): boolean;