octocode-mcp 8.1.0 → 9.0.0-alpha.2

package/dist/src/github/client.d.ts

@@ -2,4 +2,3 @@ import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types';
 export declare const OctokitWithThrottling: any;
 export declare function getOctokit(authInfo?: AuthInfo): Promise<InstanceType<typeof OctokitWithThrottling>>;
 export declare function clearCachedToken(): void;
-export declare function getDefaultBranch(owner: string, repo: string): Promise<string | null>;

package/dist/src/github/githubAPI.d.ts

@@ -50,11 +50,6 @@ export interface GitHubAPISuccess<T> {
     headers?: Record<string, string>;
 }
 export type GitHubAPIResponse<T> = GitHubAPISuccess<T> | GitHubAPIError;
-export type RepositoryReference = {
-    owner: string;
-    repo: string;
-    ref?: string;
-};
 export type OptimizedCodeSearchResult = {
     items: Array<Pick<CodeSearchResultItem, 'path' | 'url'> & {
         matches: Array<{
@@ -71,6 +66,9 @@ export type OptimizedCodeSearchResult = {
     repository?: {
         name: string;
         url: string;
+        createdAt?: string;
+        updatedAt?: string;
+        pushedAt?: string;
     };
     securityWarnings?: string[];
     minified?: boolean;

package/dist/src/github/index.d.ts

@@ -1,6 +1,6 @@
-export { getOctokit, OctokitWithThrottling, getDefaultBranch, clearCachedToken, } from './client';
+export { getOctokit, OctokitWithThrottling, clearCachedToken } from './client';
 export { handleGitHubAPIError } from './errors';
-export type { GitHubAPIError, GitHubAPIResponse, GitHubAPISuccess, Repository, OptimizedCodeSearchResult, GitHubPullRequestItem, GitHubPullRequestsSearchParams, RepositoryReference, GetContentParameters, GetRepoResponse, isGitHubAPIError, isGitHubAPISuccess, isRepository, } from './githubAPI';
+export type { GitHubAPIError, GitHubAPIResponse, GitHubAPISuccess, Repository, OptimizedCodeSearchResult, GitHubPullRequestItem, GitHubPullRequestsSearchParams, GetContentParameters, GetRepoResponse, isGitHubAPIError, isGitHubAPISuccess, isRepository, } from './githubAPI';
 export type { components } from '@octokit/openapi-types';
 export type { RestEndpointMethodTypes } from '@octokit/plugin-rest-endpoint-methods';
 export { buildCodeSearchQuery, buildRepoSearchQuery, buildPullRequestSearchQuery, shouldUseSearchForPRs, } from './queryBuilders';

package/dist/src/scheme/github_fetch_content.d.ts

@@ -15,6 +15,7 @@ export declare const FileContentQuerySchema: z.ZodEffects<z.ZodObject<{
     endLine: z.ZodOptional<z.ZodNumber>;
     matchString: z.ZodOptional<z.ZodString>;
     matchStringContextLines: z.ZodDefault<z.ZodNumber>;
+    addTimestamp: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
     path: string;
     fullContent: boolean;
@@ -26,6 +27,7 @@ export declare const FileContentQuerySchema: z.ZodEffects<z.ZodObject<{
     sanitize: boolean;
     minified: boolean;
     matchStringContextLines: number;
+    addTimestamp: boolean;
     branch?: string | undefined;
     startLine?: number | undefined;
     endLine?: number | undefined;
@@ -45,6 +47,7 @@ export declare const FileContentQuerySchema: z.ZodEffects<z.ZodObject<{
     minified?: boolean | undefined;
     matchString?: string | undefined;
     matchStringContextLines?: number | undefined;
+    addTimestamp?: boolean | undefined;
 }>, {
     path: string;
     fullContent: boolean;
@@ -56,6 +59,7 @@ export declare const FileContentQuerySchema: z.ZodEffects<z.ZodObject<{
     sanitize: boolean;
     minified: boolean;
     matchStringContextLines: number;
+    addTimestamp: boolean;
     branch?: string | undefined;
     startLine?: number | undefined;
     endLine?: number | undefined;
@@ -75,6 +79,7 @@ export declare const FileContentQuerySchema: z.ZodEffects<z.ZodObject<{
     minified?: boolean | undefined;
     matchString?: string | undefined;
     matchStringContextLines?: number | undefined;
+    addTimestamp?: boolean | undefined;
 }>;
 export declare const FileContentBulkQuerySchema: z.ZodObject<{
     queries: z.ZodArray<z.ZodEffects<z.ZodObject<{
@@ -93,6 +98,7 @@ export declare const FileContentBulkQuerySchema: z.ZodObject<{
         endLine: z.ZodOptional<z.ZodNumber>;
         matchString: z.ZodOptional<z.ZodString>;
         matchStringContextLines: z.ZodDefault<z.ZodNumber>;
+        addTimestamp: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, "strip", z.ZodTypeAny, {
         path: string;
         fullContent: boolean;
@@ -104,6 +110,7 @@ export declare const FileContentBulkQuerySchema: z.ZodObject<{
         sanitize: boolean;
         minified: boolean;
         matchStringContextLines: number;
+        addTimestamp: boolean;
         branch?: string | undefined;
         startLine?: number | undefined;
         endLine?: number | undefined;
@@ -123,6 +130,7 @@ export declare const FileContentBulkQuerySchema: z.ZodObject<{
         minified?: boolean | undefined;
         matchString?: string | undefined;
         matchStringContextLines?: number | undefined;
+        addTimestamp?: boolean | undefined;
     }>, {
         path: string;
         fullContent: boolean;
@@ -134,6 +142,7 @@ export declare const FileContentBulkQuerySchema: z.ZodObject<{
         sanitize: boolean;
         minified: boolean;
         matchStringContextLines: number;
+        addTimestamp: boolean;
         branch?: string | undefined;
         startLine?: number | undefined;
         endLine?: number | undefined;
@@ -153,6 +162,7 @@ export declare const FileContentBulkQuerySchema: z.ZodObject<{
         minified?: boolean | undefined;
         matchString?: string | undefined;
         matchStringContextLines?: number | undefined;
+        addTimestamp?: boolean | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     queries: {
@@ -166,6 +176,7 @@ export declare const FileContentBulkQuerySchema: z.ZodObject<{
         sanitize: boolean;
         minified: boolean;
         matchStringContextLines: number;
+        addTimestamp: boolean;
         branch?: string | undefined;
         startLine?: number | undefined;
         endLine?: number | undefined;
@@ -187,5 +198,6 @@ export declare const FileContentBulkQuerySchema: z.ZodObject<{
         minified?: boolean | undefined;
         matchString?: string | undefined;
         matchStringContextLines?: number | undefined;
+        addTimestamp?: boolean | undefined;
     }[];
 }>;

package/dist/src/scheme/github_search_pull_requests.d.ts

@@ -80,8 +80,8 @@ export declare const GitHubPullRequestSearchQuerySchema: z.ZodObject<{
     updated?: string | undefined;
     owner?: string | undefined;
     repo?: string | undefined;
-    sort?: "created" | "updated" | "best-match" | undefined;
     head?: string | undefined;
+    sort?: "created" | "updated" | "best-match" | undefined;
     base?: string | undefined;
     match?: ("title" | "body" | "comments")[] | undefined;
     limit?: number | undefined;
@@ -123,8 +123,8 @@ export declare const GitHubPullRequestSearchQuerySchema: z.ZodObject<{
     updated?: string | undefined;
     owner?: string | undefined;
     repo?: string | undefined;
-    sort?: "created" | "updated" | "best-match" | undefined;
     head?: string | undefined;
+    sort?: "created" | "updated" | "best-match" | undefined;
     base?: string | undefined;
     match?: ("title" | "body" | "comments")[] | undefined;
     limit?: number | undefined;
@@ -223,8 +223,8 @@ export declare const GitHubPullRequestSearchBulkQuerySchema: z.ZodObject<{
         updated?: string | undefined;
         owner?: string | undefined;
         repo?: string | undefined;
-        sort?: "created" | "updated" | "best-match" | undefined;
         head?: string | undefined;
+        sort?: "created" | "updated" | "best-match" | undefined;
         base?: string | undefined;
         match?: ("title" | "body" | "comments")[] | undefined;
         limit?: number | undefined;
@@ -266,8 +266,8 @@ export declare const GitHubPullRequestSearchBulkQuerySchema: z.ZodObject<{
         updated?: string | undefined;
         owner?: string | undefined;
         repo?: string | undefined;
-        sort?: "created" | "updated" | "best-match" | undefined;
         head?: string | undefined;
+        sort?: "created" | "updated" | "best-match" | undefined;
         base?: string | undefined;
         match?: ("title" | "body" | "comments")[] | undefined;
         limit?: number | undefined;
@@ -313,8 +313,8 @@ export declare const GitHubPullRequestSearchBulkQuerySchema: z.ZodObject<{
         updated?: string | undefined;
         owner?: string | undefined;
         repo?: string | undefined;
-        sort?: "created" | "updated" | "best-match" | undefined;
         head?: string | undefined;
+        sort?: "created" | "updated" | "best-match" | undefined;
         base?: string | undefined;
         match?: ("title" | "body" | "comments")[] | undefined;
         limit?: number | undefined;
@@ -358,8 +358,8 @@ export declare const GitHubPullRequestSearchBulkQuerySchema: z.ZodObject<{
         updated?: string | undefined;
         owner?: string | undefined;
         repo?: string | undefined;
-        sort?: "created" | "updated" | "best-match" | undefined;
         head?: string | undefined;
+        sort?: "created" | "updated" | "best-match" | undefined;
         base?: string | undefined;
         match?: ("title" | "body" | "comments")[] | undefined;
         limit?: number | undefined;

package/dist/src/scheme/package_search.d.ts

@@ -0,0 +1,196 @@
+import { z } from 'zod';
+declare const NpmPackageQuerySchema: z.ZodObject<{
+    mainResearchGoal: z.ZodString;
+    researchGoal: z.ZodString;
+    reasoning: z.ZodString;
+} & {
+    name: z.ZodString;
+    searchLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    npmFetchMetadata: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    mainResearchGoal: string;
+    researchGoal: string;
+    reasoning: string;
+    searchLimit: number;
+    npmFetchMetadata: boolean;
+}, {
+    name: string;
+    mainResearchGoal: string;
+    researchGoal: string;
+    reasoning: string;
+    searchLimit?: number | undefined;
+    npmFetchMetadata?: boolean | undefined;
+}>;
+declare const PythonPackageQuerySchema: z.ZodObject<{
+    mainResearchGoal: z.ZodString;
+    researchGoal: z.ZodString;
+    reasoning: z.ZodString;
+} & {
+    name: z.ZodString;
+    searchLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pythonFetchMetadata: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    mainResearchGoal: string;
+    researchGoal: string;
+    reasoning: string;
+    searchLimit: number;
+    pythonFetchMetadata: boolean;
+}, {
+    name: string;
+    mainResearchGoal: string;
+    researchGoal: string;
+    reasoning: string;
+    searchLimit?: number | undefined;
+    pythonFetchMetadata?: boolean | undefined;
+}>;
+export declare const PackageSearchQuerySchema: z.ZodDiscriminatedUnion<"ecosystem", [z.ZodObject<{
+    mainResearchGoal: z.ZodString;
+    researchGoal: z.ZodString;
+    reasoning: z.ZodString;
+} & {
+    name: z.ZodString;
+    searchLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    npmFetchMetadata: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+} & {
+    ecosystem: z.ZodLiteral<"npm">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    mainResearchGoal: string;
+    researchGoal: string;
+    reasoning: string;
+    searchLimit: number;
+    npmFetchMetadata: boolean;
+    ecosystem: "npm";
+}, {
+    name: string;
+    mainResearchGoal: string;
+    researchGoal: string;
+    reasoning: string;
+    ecosystem: "npm";
+    searchLimit?: number | undefined;
+    npmFetchMetadata?: boolean | undefined;
+}>, z.ZodObject<{
+    mainResearchGoal: z.ZodString;
+    researchGoal: z.ZodString;
+    reasoning: z.ZodString;
+} & {
+    name: z.ZodString;
+    searchLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pythonFetchMetadata: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+} & {
+    ecosystem: z.ZodLiteral<"python">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    mainResearchGoal: string;
+    researchGoal: string;
+    reasoning: string;
+    searchLimit: number;
+    pythonFetchMetadata: boolean;
+    ecosystem: "python";
+}, {
+    name: string;
+    mainResearchGoal: string;
+    researchGoal: string;
+    reasoning: string;
+    ecosystem: "python";
+    searchLimit?: number | undefined;
+    pythonFetchMetadata?: boolean | undefined;
+}>]>;
+export declare const PackageSearchBulkQuerySchema: z.ZodObject<{
+    queries: z.ZodArray<z.ZodDiscriminatedUnion<"ecosystem", [z.ZodObject<{
+        mainResearchGoal: z.ZodString;
+        researchGoal: z.ZodString;
+        reasoning: z.ZodString;
+    } & {
+        name: z.ZodString;
+        searchLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        npmFetchMetadata: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    } & {
+        ecosystem: z.ZodLiteral<"npm">;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        mainResearchGoal: string;
+        researchGoal: string;
+        reasoning: string;
+        searchLimit: number;
+        npmFetchMetadata: boolean;
+        ecosystem: "npm";
+    }, {
+        name: string;
+        mainResearchGoal: string;
+        researchGoal: string;
+        reasoning: string;
+        ecosystem: "npm";
+        searchLimit?: number | undefined;
+        npmFetchMetadata?: boolean | undefined;
+    }>, z.ZodObject<{
+        mainResearchGoal: z.ZodString;
+        researchGoal: z.ZodString;
+        reasoning: z.ZodString;
+    } & {
+        name: z.ZodString;
+        searchLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        pythonFetchMetadata: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    } & {
+        ecosystem: z.ZodLiteral<"python">;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        mainResearchGoal: string;
+        researchGoal: string;
+        reasoning: string;
+        searchLimit: number;
+        pythonFetchMetadata: boolean;
+        ecosystem: "python";
+    }, {
+        name: string;
+        mainResearchGoal: string;
+        researchGoal: string;
+        reasoning: string;
+        ecosystem: "python";
+        searchLimit?: number | undefined;
+        pythonFetchMetadata?: boolean | undefined;
+    }>]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    queries: ({
+        name: string;
+        mainResearchGoal: string;
+        researchGoal: string;
+        reasoning: string;
+        searchLimit: number;
+        npmFetchMetadata: boolean;
+        ecosystem: "npm";
+    } | {
+        name: string;
+        mainResearchGoal: string;
+        researchGoal: string;
+        reasoning: string;
+        searchLimit: number;
+        pythonFetchMetadata: boolean;
+        ecosystem: "python";
+    })[];
+}, {
+    queries: ({
+        name: string;
+        mainResearchGoal: string;
+        researchGoal: string;
+        reasoning: string;
+        ecosystem: "npm";
+        searchLimit?: number | undefined;
+        npmFetchMetadata?: boolean | undefined;
+    } | {
+        name: string;
+        mainResearchGoal: string;
+        researchGoal: string;
+        reasoning: string;
+        ecosystem: "python";
+        searchLimit?: number | undefined;
+        pythonFetchMetadata?: boolean | undefined;
+    })[];
+}>;
+export type NpmPackageQuery = z.infer<typeof NpmPackageQuerySchema>;
+export type PythonPackageQuery = z.infer<typeof PythonPackageQuerySchema>;
+export type PackageSearchQuery = z.infer<typeof PackageSearchQuerySchema>;
+export type PackageSearchBulkParams = z.infer<typeof PackageSearchBulkQuerySchema>;
+export {};

package/dist/src/tools/package_search.d.ts

@@ -0,0 +1,3 @@
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolInvocationCallback } from '../types.js';
+export declare function registerPackageSearchTool(server: McpServer, callback?: ToolInvocationCallback): Promise<RegisteredTool | null>;

package/dist/src/tools/toolConfig.d.ts

@@ -5,11 +5,12 @@ export interface ToolConfig {
     description: string;
     isDefault: boolean;
     type: 'search' | 'content' | 'history' | 'debug';
-    fn: (server: McpServer, callback?: ToolInvocationCallback) => RegisteredTool;
+    fn: (server: McpServer, callback?: ToolInvocationCallback) => RegisteredTool | Promise<RegisteredTool | null>;
 }
 export declare const GITHUB_SEARCH_CODE: ToolConfig;
 export declare const GITHUB_FETCH_CONTENT: ToolConfig;
 export declare const GITHUB_VIEW_REPO_STRUCTURE: ToolConfig;
 export declare const GITHUB_SEARCH_REPOSITORIES: ToolConfig;
 export declare const GITHUB_SEARCH_PULL_REQUESTS: ToolConfig;
+export declare const PACKAGE_SEARCH: ToolConfig;
 export declare const DEFAULT_TOOLS: ToolConfig[];

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

@@ -27,6 +27,7 @@ export interface CompleteMetadata {
         GITHUB_SEARCH_PULL_REQUESTS: 'githubSearchPullRequests';
         GITHUB_SEARCH_REPOSITORIES: 'githubSearchRepositories';
         GITHUB_VIEW_REPO_STRUCTURE: 'githubViewRepoStructure';
+        PACKAGE_SEARCH: 'packageSearch';
     };
     baseSchema: {
         mainResearchGoal: string;
@@ -72,6 +73,7 @@ export declare const GITHUB_FETCH_CONTENT: {
     processing: {
         minified: string;
         sanitize: string;
+        addTimestamp: string;
     };
     range: {
         startLine: string;
@@ -191,4 +193,15 @@ export declare const GITHUB_VIEW_REPO_STRUCTURE: {
         depth: string;
     };
 };
+export declare const PACKAGE_SEARCH: {
+    search: {
+        ecosystem: string;
+        name: string;
+    };
+    options: {
+        searchLimit: string;
+        npmFetchMetadata: string;
+        pythonFetchMetadata: string;
+    };
+};
 export {};

package/dist/src/types.d.ts

@@ -106,6 +106,7 @@ export interface FileContentQuery {
     matchStringContextLines?: number;
     minified?: boolean;
     sanitize?: boolean;
+    addTimestamp?: boolean;
     mainResearchGoal?: string;
     researchGoal?: string;
     reasoning?: string;
@@ -135,6 +136,8 @@ export interface ContentResultData {
     originalQuery?: FileContentQuery;
     securityWarnings?: string[];
     sampling?: SamplingInfo;
+    lastModified?: string;
+    lastModifiedBy?: string;
 }
 /** Complete file content result */
 export interface ContentResult extends BaseToolResult<FileContentQuery>, ContentResultData {
@@ -162,7 +165,9 @@ export interface SimplifiedRepository {
     stars: number;
     description: string;
     url: string;
+    createdAt: string;
     updatedAt: string;
+    pushedAt: string;
 }
 /** Repository search result */
 export interface RepoSearchResult extends BaseToolResult<GitHubReposSearchQuery> {
@@ -190,6 +195,36 @@ export interface RepoStructureResultData {
 /** Complete repository structure result */
 export interface RepoStructureResult extends BaseToolResult<GitHubViewRepoStructureQuery>, RepoStructureResultData {
 }
+/** Query parameters for searching packages */
+export interface PackageSearchQuery {
+    name: string;
+    ecosystem: 'npm' | 'python';
+    searchLimit?: number;
+    npmFetchMetadata?: boolean;
+    mainResearchGoal?: string;
+    researchGoal?: string;
+    reasoning?: string;
+}
+/** Individual package in search results */
+export interface PackageInfo {
+    name: string;
+    version: string;
+    description: string | null;
+    keywords: string[];
+    repository: string | null;
+    license?: string;
+    homepage?: string;
+    author?: string;
+}
+/** Package search result data */
+export interface PackageSearchResultData {
+    packages: PackageInfo[];
+    ecosystem: 'npm' | 'python';
+    totalFound: number;
+}
+/** Complete package search result */
+export interface PackageSearchResult extends BaseToolResult<PackageSearchQuery>, PackageSearchResultData {
+}
 /** Query parameters for searching pull requests */
 export interface GitHubPullRequestSearchQuery {
     query?: string;
@@ -425,8 +460,6 @@ export interface SanitizationResult {
     hasSecrets: boolean;
     secretsDetected: string[];
     warnings: string[];
-    hasPromptInjection?: boolean;
-    isMalicious?: boolean;
 }
 /** Result of parameter validation */
 export interface ValidationResult {

package/dist/src/utils/cache.d.ts

@@ -1,14 +1,4 @@
 import type { CacheStats } from '../types.js';
-export declare const CACHE_TTL_CONFIG: {
-    readonly 'gh-api-code': 3600;
-    readonly 'gh-api-repos': 7200;
-    readonly 'gh-api-prs': 1800;
-    readonly 'gh-api-file-content': 3600;
-    readonly 'gh-repo-structure-api': 7200;
-    readonly 'github-user': 900;
-    readonly default: 86400;
-};
-export type CachePrefix = keyof typeof CACHE_TTL_CONFIG | string;
 export declare function generateCacheKey(prefix: string, params: unknown, sessionId?: string): string;
 /**
  * Generic typed cache wrapper for raw data (avoids JSON round-trips)

package/dist/src/utils/diffParser.d.ts

@@ -1,8 +1 @@
-export interface PatchLine {
-    originalLineNumber: number | null;
-    newLineNumber: number | null;
-    content: string;
-    type: 'context' | 'addition' | 'deletion';
-}
-export declare function parsePatch(patch: string): PatchLine[];
 export declare function filterPatch(patch: string, additions?: number[], deletions?: number[]): string;

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

@@ -1,3 +1,25 @@
-import { CallToolResult } from '@modelcontextprotocol/sdk/types';
-export declare function parseExecResult(stdout: string, stderr: string, error?: Error | null, exitCode?: number): CallToolResult;
 export declare function getGithubCLIToken(): Promise<string | null>;
+declare const ALLOWED_NPM_COMMANDS: readonly ["view", "search", "ping", "config", "whoami"];
+type NpmCommand = (typeof ALLOWED_NPM_COMMANDS)[number];
+type NpmExecOptions = {
+    timeout?: number;
+    cwd?: string;
+    env?: Record<string, string>;
+};
+interface NpmExecResult {
+    stdout: string;
+    stderr: string;
+    error?: Error;
+    exitCode?: number;
+}
+/**
+ * Check if npm registry is available by running `npm ping`
+ * @param timeoutMs - Timeout in milliseconds (default 10000ms)
+ * @returns true if npm registry is reachable, false otherwise
+ */
+export declare function checkNpmAvailability(timeoutMs?: number): Promise<boolean>;
+/**
+ * Execute NPM command with security validation using spawn (safer than exec)
+ */
+export declare function executeNpmCommand(command: NpmCommand, args: string[], options?: NpmExecOptions): Promise<NpmExecResult>;
+export {};

package/dist/src/utils/githubRepoFallback.d.ts

@@ -0,0 +1,17 @@
+import type { NpmPackageResult } from './package.js';
+/**
+ * Attempts to infer the GitHub repository for an npm package
+ * when the npm registry doesn't have the repository field.
+ *
+ * Uses heuristics and known mappings - no API calls required.
+ */
+export declare function tryInferRepoUrl(packageName: string, existingResult: NpmPackageResult): NpmPackageResult;
+/**
+ * Add a new known package to repo mapping at runtime.
+ * Useful for caching discovered mappings.
+ */
+export declare function addKnownPackageRepo(packageName: string, repoUrl: string): void;
+/**
+ * Get the GitHub organization for a given npm scope.
+ */
+export declare function getOrgForScope(scope: string): string | undefined;

package/dist/src/utils/npmPackage.d.ts

@@ -0,0 +1,3 @@
+import { PackageSearchAPIResult, PackageSearchError, DeprecationInfo } from './package.js';
+export declare function searchNpmPackage(packageName: string, limit: number, fetchMetadata: boolean): Promise<PackageSearchAPIResult | PackageSearchError>;
+export declare function checkNpmDeprecation(packageName: string): Promise<DeprecationInfo | null>;

package/dist/src/utils/package.d.ts

@@ -0,0 +1,50 @@
+import { checkNpmDeprecation } from './npmPackage.js';
+export interface PackageSearchInput {
+    ecosystem: 'npm' | 'python';
+    name: string;
+    searchLimit?: number;
+    npmFetchMetadata?: boolean;
+    pythonFetchMetadata?: boolean;
+    mainResearchGoal?: string;
+    researchGoal?: string;
+    reasoning?: string;
+}
+export interface MinimalPackageResult {
+    name: string;
+    repository: string | null;
+}
+export interface NpmPackageResult {
+    repoUrl: string | null;
+    path: string;
+    version: string;
+    mainEntry: string | null;
+    typeDefinitions: string | null;
+    lastPublished?: string;
+}
+export interface PythonPackageResult {
+    name: string;
+    version: string;
+    description: string | null;
+    keywords: string[];
+    repository: string | null;
+    homepage?: string;
+    author?: string;
+    license?: string;
+    lastPublished?: string;
+}
+export type PackageResult = MinimalPackageResult | NpmPackageResult | PythonPackageResult;
+export interface PackageSearchAPIResult {
+    packages: PackageResult[];
+    ecosystem: 'npm' | 'python';
+    totalFound: number;
+}
+export interface PackageSearchError {
+    error: string;
+    hints?: string[];
+}
+export interface DeprecationInfo {
+    deprecated: boolean;
+    message?: string;
+}
+export declare function searchPackage(query: PackageSearchInput): Promise<PackageSearchAPIResult | PackageSearchError>;
+export { checkNpmDeprecation };

package/dist/src/utils/pythonPackage.d.ts

@@ -0,0 +1,2 @@
+import { PackageSearchAPIResult, PackageSearchError } from './package.js';
+export declare function searchPythonPackage(packageName: string, fetchMetadata: boolean): Promise<PackageSearchAPIResult | PackageSearchError>;

package/dist/tests/security/mask.branches.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/tools/package_search.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/tools/toolConfig.branches.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/tools/toolConfig.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/tools/toolMetadata.branches.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/utils/githubRepoFallback.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/utils/npmPackage.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/utils/pythonPackage.test.d.ts

@@ -0,0 +1 @@
+export {};