@octocodeai/octocode-tools-core 16.2.0

package/dist/github/githubAPI.d.ts

@@ -0,0 +1,237 @@
+import type { components } from '@octokit/openapi-types';
+import type { RestEndpointMethodTypes } from '@octokit/plugin-rest-endpoint-methods';
+export type Repository = components['schemas']['full-repository'];
+export type ContentDirectoryEntry = components['schemas']['content-directory'][number];
+export type CodeSearchResultItem = components['schemas']['code-search-result-item'];
+export type RepoSearchResultItem = components['schemas']['repo-search-result-item'];
+export type IssueSearchResultItem = components['schemas']['issue-search-result-item'];
+export type DiffEntry = components['schemas']['diff-entry'];
+export type PullRequestItem = components['schemas']['pull-request'];
+export type PullRequestSimple = components['schemas']['pull-request-simple'];
+export type IssueComment = components['schemas']['issue-comment'];
+export interface PRReviewInfo {
+    id: string;
+    user: string;
+    state: string;
+    body: string;
+    submitted_at?: string;
+    commit_id?: string;
+}
+export interface CommitFileInfo {
+    filename: string;
+    status: string;
+    additions: number;
+    deletions: number;
+    changes?: number;
+    patch?: string;
+}
+export interface CommitInfo {
+    sha: string;
+    message: string;
+    author: string;
+    date: string;
+    files: CommitFileInfo[];
+}
+export interface HistoryCommitFile {
+    filename: string;
+    status: string;
+    additions: number;
+    deletions: number;
+    patch?: string;
+    previousFilename?: string;
+}
+export interface HistoryCommit {
+    sha: string;
+    date: string;
+    message: string;
+    messageHeadline: string;
+    url: string;
+    author: {
+        name: string;
+        email: string;
+        login?: string;
+    };
+    committer?: {
+        name: string;
+        email: string;
+        login?: string;
+    };
+    additions?: number;
+    deletions?: number;
+    status?: string;
+    patch?: string;
+    previousFilename?: string;
+    files?: HistoryCommitFile[];
+}
+export interface HistoryResult {
+    type: 'file' | 'repo';
+    owner: string;
+    repo: string;
+    path?: string;
+    commits: HistoryCommit[];
+    pagination: {
+        page: number;
+        perPage: number;
+        hasMore: boolean;
+        nextPage?: number;
+    };
+}
+export type GetContentParameters = RestEndpointMethodTypes['repos']['getContent']['parameters'];
+export type SearchCodeParameters = RestEndpointMethodTypes['search']['code']['parameters'];
+export type SearchCodeResponse = RestEndpointMethodTypes['search']['code']['response'];
+export type SearchReposParameters = RestEndpointMethodTypes['search']['repos']['parameters'];
+export interface GitHubAPIError {
+    error: string;
+    status?: number;
+    type: 'http' | 'graphql' | 'network' | 'unknown';
+    scopesSuggestion?: string;
+    rateLimitRemaining?: number;
+    rateLimitReset?: number;
+    retryAfter?: number;
+    hints?: string[];
+}
+export interface GitHubAPISuccess<T> {
+    data: T;
+    status: number;
+    headers?: Record<string, string>;
+    rawResponseChars?: number;
+}
+export type GitHubAPIResponse<T> = GitHubAPISuccess<T> | GitHubAPIError;
+export type OptimizedCodeSearchResult = {
+    items: Array<Pick<CodeSearchResultItem, 'path' | 'url'> & {
+        matches: Array<{
+            context: string;
+            positions: [number, number][];
+        }>;
+        repository: {
+            nameWithOwner: string;
+            url: string;
+            pushedAt?: string;
+        };
+        minificationType?: string;
+        lastModifiedAt?: string;
+    }>;
+    total_count: number;
+    repository?: {
+        name: string;
+        url: string;
+        createdAt?: string;
+        updatedAt?: string;
+        pushedAt?: string;
+    };
+    matchLocations?: string[];
+    minified?: boolean;
+    minificationFailed?: boolean;
+    minificationTypes?: string[];
+    _researchContext?: {
+        uniqueFileCount: number;
+        repositoryContext?: {
+            owner: string;
+            repo: string;
+            branch?: string;
+        };
+    };
+    pagination?: {
+        currentPage: number;
+        totalPages: number;
+        perPage: number;
+        totalMatches?: number;
+        reportedTotalMatches?: number;
+        reachableTotalMatches?: number;
+        totalMatchesKind?: 'exact' | 'reported' | 'lowerBound';
+        totalMatchesCapped?: boolean;
+        hasMore: boolean;
+        uniqueFileCount?: number;
+    };
+    nonExistentScope?: boolean;
+};
+export interface PRCommentItem {
+    id: string;
+    user: string;
+    body: string;
+    created_at: string;
+    updated_at: string;
+    commentType?: 'discussion' | 'review_inline';
+    path?: string;
+    line?: number;
+    in_reply_to_id?: number | null;
+}
+export type GitHubPullRequestItem = Pick<IssueSearchResultItem, 'number' | 'title' | 'body' | 'state' | 'created_at' | 'updated_at' | 'closed_at' | 'url' | 'draft'> & {
+    author: string;
+    labels: string[];
+    merged_at?: string;
+    comments?: PRCommentItem[];
+    total_comment_count?: number;
+    reactions: number;
+    head?: string;
+    base?: string;
+    head_sha?: string;
+    base_sha?: string;
+    additions?: number;
+    deletions?: number;
+    file_changes?: {
+        total_count: number;
+        files: DiffEntry[];
+    };
+    commits?: CommitInfo[];
+    reviews?: PRReviewInfo[];
+    _sanitization_warnings?: string[];
+};
+export interface GitHubPullRequestsSearchParams {
+    query?: string;
+    owner?: string | string[];
+    repo?: string | string[];
+    prNumber?: number;
+    state?: 'open' | 'closed' | 'merged';
+    draft?: boolean;
+    merged?: boolean;
+    author?: string;
+    assignee?: string;
+    mentions?: string;
+    commenter?: string;
+    involves?: string;
+    'reviewed-by'?: string;
+    'review-requested'?: string;
+    head?: string;
+    base?: string;
+    created?: string;
+    updated?: string;
+    'merged-at'?: string;
+    closed?: string;
+    comments?: number | string;
+    reactions?: number | string;
+    interactions?: number | string;
+    label?: string | string[];
+    milestone?: string;
+    language?: string;
+    checks?: 'pending' | 'success' | 'failure';
+    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';
+    order?: 'asc' | 'desc';
+    limit?: number;
+    exhaustive?: boolean;
+    maxPages?: number;
+    pageSize?: number;
+    page?: number;
+    charOffset?: number;
+    charLength?: number;
+    content?: unknown;
+    reviewMode?: 'summary' | 'full';
+    filePage?: number;
+    commentPage?: number;
+    commitPage?: number;
+    itemsPerPage?: number;
+}
+export declare function isGitHubAPIError(obj: unknown): obj is GitHubAPIError;
+export declare function isGitHubAPISuccess<T>(obj: unknown): obj is GitHubAPISuccess<T>;
+export declare function isRepository(obj: unknown): obj is Repository;

package/dist/github/history.d.ts

@@ -0,0 +1,16 @@
+import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+import type { GitHubAPIResponse, HistoryResult } from './githubAPI.js';
+export declare function fetchHistory(params: {
+    type: 'file' | 'repo';
+    owner: string;
+    repo: string;
+    path?: string;
+    branch?: string;
+    since?: string;
+    until?: string;
+    author?: string;
+    page: number;
+    perPage: number;
+    includeDiff: boolean;
+    charLength?: number;
+}, authInfo?: AuthInfo): Promise<GitHubAPIResponse<HistoryResult>>;

package/dist/github/prByNumber.d.ts

@@ -0,0 +1,5 @@
+import type { GitHubPullRequestsSearchParams } from './githubAPI.js';
+import type { GitHubPullRequestSearchApiResult } from '../tools/github_search_pull_requests/types.js';
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
+export declare function fetchGitHubPullRequestByNumberAPI(params: GitHubPullRequestsSearchParams, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubPullRequestSearchApiResult>;
+export declare function fetchGitHubPullRequestByNumberAPIInternal(params: GitHubPullRequestsSearchParams, authInfo?: AuthInfo): Promise<GitHubPullRequestSearchApiResult>;

package/dist/github/prContentFetcher.d.ts

@@ -0,0 +1,5 @@
+import { GitHubPullRequestsSearchParams, GitHubPullRequestItem, IssueSearchResultItem, PullRequestSimple, PullRequestItem } from './githubAPI.js';
+import { OctokitWithThrottling } from './client.js';
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
+export declare function transformPullRequestItemFromSearch(item: IssueSearchResultItem, params: GitHubPullRequestsSearchParams, octokit: InstanceType<typeof OctokitWithThrottling>): Promise<GitHubPullRequestItem>;
+export declare function transformPullRequestItemFromREST(item: PullRequestSimple | PullRequestItem, params: GitHubPullRequestsSearchParams, octokit: InstanceType<typeof OctokitWithThrottling>, authInfo?: AuthInfo): Promise<GitHubPullRequestItem>;

package/dist/github/prTransformation.d.ts

@@ -0,0 +1,109 @@
+import { GitHubPullRequestsSearchParams, GitHubPullRequestItem, DiffEntry, CommitFileInfo } from './githubAPI.js';
+interface RawPRData {
+    number: number;
+    title?: string | null;
+    body?: string | null;
+    state?: string | null;
+    user?: {
+        login: string;
+    } | null;
+    labels?: (string | {
+        name?: string | null;
+    })[] | null;
+    created_at?: string | null;
+    updated_at?: string | null;
+    closed_at?: string | null;
+    html_url: string;
+    draft?: boolean | null;
+    merged_at?: string | null;
+    head?: {
+        ref?: string;
+        sha?: string;
+    };
+    base?: {
+        ref?: string;
+        sha?: string;
+    };
+    comments?: number | null;
+}
+export declare function createBasePRTransformation(item: RawPRData): {
+    prData: GitHubPullRequestItem;
+    sanitizationWarnings: Set<string>;
+};
+interface PRResponseFormatOptions {
+    includeFullBody?: boolean;
+    includeFullCommentDetails?: boolean;
+    charOffset?: number;
+    charLength?: number;
+}
+interface TextPaginationInfo {
+    charOffset: number;
+    charLength: number;
+    totalChars: number;
+    hasMore: boolean;
+    nextCharOffset?: number;
+}
+export declare function formatPRForResponse(pr: GitHubPullRequestItem, options?: PRResponseFormatOptions): {
+    _sanitization_warnings: string[];
+    comment_details_paginated?: boolean;
+    comment_details: {
+        body_pagination?: TextPaginationInfo;
+        body: string;
+        id: string;
+        user: string;
+        created_at: string;
+        updated_at: string;
+        commentType?: "discussion" | "review_inline";
+        path?: string;
+        line?: number;
+        in_reply_to_id?: number | null;
+    }[];
+    comment_details_shown: number;
+    comment_details_total: number;
+    commit_details: import("./githubAPI.js").CommitInfo[];
+    reviews: import("./githubAPI.js").PRReviewInfo[];
+    file_changes: {
+        filename: string;
+        status: "added" | "removed" | "modified" | "renamed" | "copied" | "changed" | "unchanged";
+        additions: number;
+        deletions: number;
+        patch: string;
+    }[];
+    commits: number;
+    additions: number;
+    deletions: number;
+    changed_files: number;
+    comment_details_breakdown: {
+        inline_review: number;
+        discussion: number;
+    };
+    comments: number;
+    body_pagination?: TextPaginationInfo;
+    body: string;
+    base_sha?: string;
+    base_ref: string;
+    head_sha?: string;
+    head_ref: string;
+    labels?: {
+        id: number;
+        name: string;
+        color: string;
+    }[];
+    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;
+    author: string;
+};
+export declare function normalizeOwnerRepo(params: GitHubPullRequestsSearchParams): {
+    owner: string | undefined;
+    repo: string | undefined;
+};
+export declare function applyPartialContentFilter(files: (DiffEntry | CommitFileInfo)[], params: GitHubPullRequestsSearchParams): (DiffEntry | CommitFileInfo)[];
+export {};

package/dist/github/pullRequestSearch.d.ts

@@ -0,0 +1,4 @@
+import type { GitHubPullRequestsSearchParams } from './githubAPI.js';
+import type { GitHubPullRequestSearchApiResult } from '../tools/github_search_pull_requests/types.js';
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
+export declare function searchGitHubPullRequestsAPI(params: GitHubPullRequestsSearchParams, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubPullRequestSearchApiResult>;

package/dist/github/queryBuilders.d.ts

@@ -0,0 +1,12 @@
+import type { z } from 'zod';
+import type { GitHubCodeSearchQuerySchema, GitHubReposSearchSingleQuerySchema } from '@octocodeai/octocode-core/schemas';
+type GitHubCodeSearchQuery = z.infer<typeof GitHubCodeSearchQuerySchema>;
+type GitHubReposSearchSingleQuery = z.infer<typeof GitHubReposSearchSingleQuerySchema>;
+import type { WithOptionalMeta } from '../types/execution.js';
+import { GitHubPullRequestsSearchParams } from './githubAPI.js';
+export declare function getOwnerQualifier(owner: string): string;
+export declare function buildCodeSearchQuery(params: WithOptionalMeta<GitHubCodeSearchQuery>): string;
+export declare function buildRepoSearchQuery(params: WithOptionalMeta<GitHubReposSearchSingleQuery>): string;
+export declare function buildPullRequestSearchQuery(params: GitHubPullRequestsSearchParams): string;
+export declare function shouldUseSearchForPRs(params: GitHubPullRequestsSearchParams): boolean;
+export {};

package/dist/github/repoSearch.d.ts

@@ -0,0 +1,25 @@
+import type { GitHubAPIResponse } from './githubAPI.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 { WithOptionalMeta } from '../types/execution.js';
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
+interface RepoSearchPagination {
+    currentPage: number;
+    totalPages: number;
+    perPage: number;
+    totalMatches: number;
+    reportedTotalMatches?: number;
+    reachableTotalMatches?: number;
+    totalMatchesKind?: 'exact' | 'reported' | 'lowerBound';
+    totalMatchesCapped?: boolean;
+    hasMore: boolean;
+}
+interface RepoSearchAPIData {
+    repositories: GitHubRepositoryOutput[];
+    pagination?: RepoSearchPagination;
+    nonExistentScope?: boolean;
+}
+export declare function searchGitHubReposAPI(params: WithOptionalMeta<GitHubReposSearchSingleQuery>, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubAPIResponse<RepoSearchAPIData>>;
+export {};

package/dist/github/repoStructure.d.ts

@@ -0,0 +1,7 @@
+import type { z } from 'zod';
+import type { GitHubViewRepoStructureQuerySchema } from '@octocodeai/octocode-core/schemas';
+type GitHubViewRepoStructureQuery = z.infer<typeof GitHubViewRepoStructureQuerySchema>;
+import type { GitHubRepositoryStructureResult, GitHubRepositoryStructureError } from '../tools/github_view_repo_structure/types.js';
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
+export declare function viewGitHubRepositoryStructureAPI(params: GitHubViewRepoStructureQuery, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubRepositoryStructureResult | GitHubRepositoryStructureError>;
+export {};

package/dist/github/repoStructurePagination.d.ts

@@ -0,0 +1,6 @@
+import type { z } from 'zod';
+import type { GitHubViewRepoStructureQuerySchema } from '@octocodeai/octocode-core/schemas';
+type GitHubViewRepoStructureQuery = z.infer<typeof GitHubViewRepoStructureQuerySchema>;
+import type { GitHubRepositoryStructureResult } from '../tools/github_view_repo_structure/types.js';
+export declare function applyStructurePagination(cachedResult: GitHubRepositoryStructureResult, params: GitHubViewRepoStructureQuery): GitHubRepositoryStructureResult;
+export {};

package/dist/github/repoStructureRecursive.d.ts

@@ -0,0 +1,3 @@
+import type { GitHubApiFileItem } from '../tools/github_view_repo_structure/types.js';
+import { OctokitWithThrottling } from './client.js';
+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/github/responseHeaders.d.ts

@@ -0,0 +1 @@
+export declare function normalizeResponseHeaders(headers: unknown): Record<string, string>;

package/dist/hints/dynamic.d.ts

@@ -0,0 +1,6 @@
+import type { HintContext, HintStatus, ToolHintGenerators } from './types.js';
+export declare const HINTS: Record<string, ToolHintGenerators>;
+type DynamicToolName = keyof typeof HINTS;
+export declare function hasDynamicHints(toolName: string): toolName is DynamicToolName;
+export declare function getDynamicHints(toolName: string, status: HintStatus, context?: HintContext): string[];
+export {};

package/dist/hints/index.d.ts

@@ -0,0 +1,2 @@
+import type { HintContext, HintStatus } from './types.js';
+export declare function getHints(toolName: string, status: HintStatus, context?: HintContext): string[];

package/dist/hints/types.d.ts

@@ -0,0 +1 @@
+export type { HintContext, HintStatus, ToolHintGenerators, } from '../types/metadata.js';

package/dist/index.d.ts

@@ -0,0 +1,187 @@
+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';
+export * from './errors/localToolErrors.js';
+export * from './errors/pathUtils.js';
+export * from './errors/ToolError.js';
+export * from './github/client.js';
+export * from './github/codeSearch.js';
+export * from './github/directoryFetch.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 * from './github/prByNumber.js';
+export * from './github/prContentFetcher.js';
+export * from './github/prTransformation.js';
+export * from './github/pullRequestSearch.js';
+export * from './github/history.js';
+export * from './github/queryBuilders.js';
+export * from './github/repoSearch.js';
+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';
+export * from './providers/github/GitHubProvider.js';
+export * from './providers/github/githubPullRequests.js';
+export * from './providers/github/githubSearch.js';
+export * from './providers/github/githubStructure.js';
+export * from './providers/github/utils.js';
+export * from './providers/providerQueries.js';
+export * from './responses.js';
+export * from './scheme/fields.js';
+export * from './scheme/responseEnvelope.js';
+export * from './serverConfig.js';
+export * from './session.js';
+export * from './tools/executionGuard.js';
+export * from './tools/github_clone_repo/cache.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';
+export * from './tools/github_clone_repo/types.js';
+export * from './tools/github_fetch_content/execution.js';
+export * from './tools/github_fetch_content/finalizer.js';
+export * from './tools/github_fetch_content/scheme.js';
+export * from './tools/github_fetch_content/types.js';
+export * from './tools/github_search_code/execution.js';
+export * from './tools/github_search_code/finalizer.js';
+export * from './tools/github_search_code/scheme.js';
+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/types.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';
+export * from './tools/github_view_repo_structure/execution.js';
+export * from './tools/github_view_repo_structure/scheme.js';
+export * from './tools/github_view_repo_structure/types.js';
+export * from './tools/local_binary_inspect/execution.js';
+export * from './tools/local_binary_inspect/scheme.js';
+export * from './tools/local_fetch_content/contentExtractor.js';
+export * from './tools/local_fetch_content/execution.js';
+export * from './tools/local_fetch_content/fetchContent.js';
+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_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';
+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/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 * from './tools/package_search/scheme.js';
+export * from './tools/providerExecution.js';
+export * from './tools/providerMappers.js';
+export * from './tools/toolConfig.js';
+export * from './tools/toolMetadata/baseSchema.js';
+export * from './tools/toolMetadata/descriptions.js';
+export * from './tools/toolMetadata/gateway.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/toolNames.js';
+export * from './tools/utils.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';
+export * from './types/session.js';
+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/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';
+export * from './utils/file/filters.js';
+export * from './utils/file/size.js';
+export * from './utils/file/toolHelpers.js';
+export * from './utils/http/cache.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 * from './utils/package/schemas.js';
+export * from './utils/package/types.js';
+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';
+export * from './utils/parsers/schemas.js';
+export * from './utils/response/bulk.js';
+export * from './utils/response/callToolResult.js';
+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';
+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 { 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 { completeMetadata } from '@octocodeai/octocode-core';
+export { z } from 'zod';