dep-context-mcp 1.0.0

package/dist/resolver/package.js

@@ -0,0 +1,334 @@
+/**
+ * Package resolver - locates packages within node_modules and extracts metadata
+ */
+import { readFile, access } from 'node:fs/promises';
+import { join, dirname, resolve as pathResolve } from 'node:path';
+import { existsSync } from 'node:fs';
+export class PackageResolverError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PackageResolverError';
+    }
+}
+/**
+ * Extracts repository URL from package.json repository field
+ */
+function extractRepositoryUrl(repository) {
+    if (!repository)
+        return undefined;
+    if (typeof repository === 'string') {
+        // Handle shorthand like "github:user/repo"
+        if (repository.startsWith('github:')) {
+            return `https://github.com/${repository.slice(7)}`;
+        }
+        if (repository.startsWith('gitlab:')) {
+            return `https://gitlab.com/${repository.slice(7)}`;
+        }
+        return repository;
+    }
+    if (typeof repository === 'object' && repository !== null) {
+        const repo = repository;
+        if (repo.url) {
+            // Clean up git URLs
+            let url = repo.url;
+            if (url.startsWith('git+')) {
+                url = url.slice(4);
+            }
+            if (url.endsWith('.git')) {
+                url = url.slice(0, -4);
+            }
+            // Convert git:// to https://
+            if (url.startsWith('git://')) {
+                url = 'https://' + url.slice(6);
+            }
+            return url;
+        }
+    }
+    return undefined;
+}
+/**
+ * Parses package.json content and extracts metadata
+ */
+export function parsePackageJson(content, packagePath) {
+    let pkg;
+    try {
+        pkg = JSON.parse(content);
+    }
+    catch {
+        throw new PackageResolverError(`Invalid JSON in package.json at ${packagePath}`);
+    }
+    if (typeof pkg['name'] !== 'string') {
+        throw new PackageResolverError(`Missing or invalid "name" field in package.json at ${packagePath}`);
+    }
+    if (typeof pkg['version'] !== 'string') {
+        throw new PackageResolverError(`Missing or invalid "version" field in package.json at ${packagePath}`);
+    }
+    // Extract types path from various fields
+    let typesPath;
+    if (typeof pkg['types'] === 'string') {
+        typesPath = pkg['types'];
+    }
+    else if (typeof pkg['typings'] === 'string') {
+        typesPath = pkg['typings'];
+    }
+    // Extract export map
+    const exportMap = {};
+    if (pkg['exports'] && typeof pkg['exports'] === 'object') {
+        const exports = pkg['exports'];
+        for (const [key, value] of Object.entries(exports)) {
+            if (typeof value === 'string') {
+                exportMap[key] = value;
+            }
+            else if (typeof value === 'object' && value !== null) {
+                const exportEntry = value;
+                // Prefer types, then import, then require, then default
+                if (typeof exportEntry['types'] === 'string') {
+                    exportMap[key] = exportEntry['types'];
+                }
+                else if (typeof exportEntry['import'] === 'string') {
+                    exportMap[key] = exportEntry['import'];
+                }
+                else if (typeof exportEntry['require'] === 'string') {
+                    exportMap[key] = exportEntry['require'];
+                }
+                else if (typeof exportEntry['default'] === 'string') {
+                    exportMap[key] = exportEntry['default'];
+                }
+            }
+        }
+    }
+    return {
+        name: pkg['name'],
+        version: pkg['version'],
+        description: typeof pkg['description'] === 'string' ? pkg['description'] : undefined,
+        typesPath,
+        mainPath: typeof pkg['main'] === 'string' ? pkg['main'] : undefined,
+        exportMap,
+        dependencies: pkg['dependencies'] ?? {},
+        devDependencies: pkg['devDependencies'] ?? {},
+        repository: extractRepositoryUrl(pkg['repository'])
+    };
+}
+/**
+ * Resolves a package name to its path in node_modules
+ * Handles scoped packages and hoisted/nested structures
+ */
+export async function resolvePackagePath(packageName, projectRoot) {
+    // Handle scoped packages: @scope/name -> @scope/name
+    const packageDir = packageName.startsWith('@')
+        ? packageName
+        : packageName.split('/')[0];
+    // Start from project root and walk up looking for node_modules
+    let currentDir = pathResolve(projectRoot);
+    const root = dirname(currentDir);
+    while (currentDir !== root) {
+        const candidatePath = join(currentDir, 'node_modules', packageDir);
+        try {
+            await access(candidatePath);
+            const pkgJsonPath = join(candidatePath, 'package.json');
+            await access(pkgJsonPath);
+            return candidatePath;
+        }
+        catch {
+            // Not found at this level, try parent
+        }
+        currentDir = dirname(currentDir);
+    }
+    return undefined;
+}
+/**
+ * Finds the types entry point for a package
+ */
+export async function findTypesEntry(packagePath, metadata) {
+    // 1. Check types/typings field from package.json
+    if (metadata.typesPath) {
+        const typesFullPath = join(packagePath, metadata.typesPath);
+        if (existsSync(typesFullPath)) {
+            return typesFullPath;
+        }
+    }
+    // 2. Check exports["."].types
+    if (metadata.exportMap['.']) {
+        const exportTypes = metadata.exportMap['.'];
+        if (exportTypes.endsWith('.d.ts')) {
+            const exportTypesPath = join(packagePath, exportTypes);
+            if (existsSync(exportTypesPath)) {
+                return exportTypesPath;
+            }
+        }
+    }
+    // 3. Check for index.d.ts in package root
+    const rootIndexDts = join(packagePath, 'index.d.ts');
+    if (existsSync(rootIndexDts)) {
+        return rootIndexDts;
+    }
+    // 4. Check for dist/index.d.ts
+    const distIndexDts = join(packagePath, 'dist', 'index.d.ts');
+    if (existsSync(distIndexDts)) {
+        return distIndexDts;
+    }
+    // 5. Check for lib/index.d.ts
+    const libIndexDts = join(packagePath, 'lib', 'index.d.ts');
+    if (existsSync(libIndexDts)) {
+        return libIndexDts;
+    }
+    // 6. Check for types/index.d.ts
+    const typesIndexDts = join(packagePath, 'types', 'index.d.ts');
+    if (existsSync(typesIndexDts)) {
+        return typesIndexDts;
+    }
+    return undefined;
+}
+/**
+ * Resolves types path for a specific subpath export
+ */
+async function resolveSubpathTypes(packagePath, _subpath, exportValue) {
+    // Handle string export
+    if (typeof exportValue === 'string') {
+        // Check if it's a .d.ts file
+        if (exportValue.endsWith('.d.ts')) {
+            const fullPath = join(packagePath, exportValue);
+            if (existsSync(fullPath))
+                return fullPath;
+        }
+        // Try replacing .js with .d.ts
+        const dtsPath = exportValue.replace(/\.js$/, '.d.ts');
+        const fullDtsPath = join(packagePath, dtsPath);
+        if (existsSync(fullDtsPath))
+            return fullDtsPath;
+        return undefined;
+    }
+    // Handle conditional export object
+    if (typeof exportValue === 'object' && exportValue !== null) {
+        const entry = exportValue;
+        // Prefer types condition
+        if (typeof entry['types'] === 'string') {
+            const fullPath = join(packagePath, entry['types']);
+            if (existsSync(fullPath))
+                return fullPath;
+        }
+        // Try import/require and convert to .d.ts
+        const jsPath = entry['import'] ?? entry['require'] ?? entry['default'];
+        if (typeof jsPath === 'string') {
+            const dtsPath = jsPath.replace(/\.js$/, '.d.ts');
+            const fullDtsPath = join(packagePath, dtsPath);
+            if (existsSync(fullDtsPath))
+                return fullDtsPath;
+        }
+    }
+    return undefined;
+}
+/**
+ * Lists all subpath exports with their types paths
+ */
+export async function listSubpathExports(packagePath, _metadata) {
+    const results = [];
+    // Read package.json to get raw exports
+    const pkgJsonPath = join(packagePath, 'package.json');
+    let pkg;
+    try {
+        const content = await readFile(pkgJsonPath, 'utf-8');
+        pkg = JSON.parse(content);
+    }
+    catch {
+        return results;
+    }
+    const exports = pkg['exports'];
+    if (!exports || typeof exports !== 'object') {
+        return results;
+    }
+    const exportsMap = exports;
+    for (const [subpath, value] of Object.entries(exportsMap)) {
+        // Skip main entry point and internal paths
+        if (subpath === '.' || subpath.startsWith('./package.json'))
+            continue;
+        // Skip wildcard patterns for now (complex to resolve)
+        if (subpath.includes('*'))
+            continue;
+        const typesPath = await resolveSubpathTypes(packagePath, subpath, value);
+        results.push({ subpath, typesPath });
+    }
+    return results;
+}
+/**
+ * Resolves a package and returns its metadata
+ */
+export async function resolve(packageName, projectRoot) {
+    const packagePath = await resolvePackagePath(packageName, projectRoot);
+    if (!packagePath) {
+        return {
+            success: false,
+            packagePath: undefined,
+            metadata: undefined,
+            error: `Package "${packageName}" not found in node_modules. Run npm install.`
+        };
+    }
+    try {
+        const pkgJsonPath = join(packagePath, 'package.json');
+        const content = await readFile(pkgJsonPath, 'utf-8');
+        const metadata = parsePackageJson(content, packagePath);
+        // Find types entry point
+        const typesEntry = await findTypesEntry(packagePath, metadata);
+        if (typesEntry) {
+            metadata.typesPath = typesEntry;
+        }
+        return {
+            success: true,
+            packagePath,
+            metadata,
+            error: undefined
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            packagePath,
+            metadata: undefined,
+            error: message
+        };
+    }
+}
+/**
+ * Lists all dependencies from the project's package.json
+ */
+export async function listAllDependencies(projectRoot, includeDev = false) {
+    const pkgJsonPath = join(projectRoot, 'package.json');
+    let content;
+    try {
+        content = await readFile(pkgJsonPath, 'utf-8');
+    }
+    catch {
+        throw new PackageResolverError(`Could not read package.json at ${pkgJsonPath}`);
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(content);
+    }
+    catch {
+        throw new PackageResolverError(`Invalid JSON in package.json at ${pkgJsonPath}`);
+    }
+    const deps = pkg['dependencies'] ?? {};
+    const devDeps = includeDev ? (pkg['devDependencies'] ?? {}) : {};
+    const allDeps = { ...deps, ...devDeps };
+    const results = [];
+    for (const packageName of Object.keys(allDeps)) {
+        const result = await resolve(packageName, projectRoot);
+        if (result.success && result.metadata) {
+            results.push(result.metadata);
+        }
+    }
+    return results;
+}
+/**
+ * Creates a PackageResolver instance
+ */
+export function createPackageResolver(projectRoot) {
+    return {
+        resolve: (packageName) => resolve(packageName, projectRoot),
+        findTypesEntry: (packagePath, metadata) => findTypesEntry(packagePath, metadata),
+        listAllDependencies: (includeDev) => listAllDependencies(projectRoot, includeDev),
+        listSubpathExports: (packagePath, metadata) => listSubpathExports(packagePath, metadata)
+    };
+}
+//# sourceMappingURL=package.js.map

package/dist/resolver/package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","sourceRoot":"","sources":["../../src/resolver/package.ts"],"names":[],"mappings":"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"}

package/dist/tools/get-dependency.d.ts

@@ -0,0 +1,55 @@
+/**
+ * MCP Tool: get_dependency_context
+ *
+ * Retrieves API context for an installed dependency.
+ * Checks cache first, generates snapshot on miss.
+ */
+import type { CacheManager } from '../cache/manager.js';
+import type { Config } from '../config/loader.js';
+export interface GetDependencyContextInput {
+    packageName: string;
+}
+export interface GetDependencyContextOutput {
+    snapshot: string;
+    cached: boolean;
+    version: string;
+}
+export interface GetDependencyContextError {
+    error: string;
+    code: 'NOT_FOUND' | 'NO_TYPES' | 'EXTRACTION_FAILED';
+}
+export type GetDependencyContextResult = GetDependencyContextOutput | GetDependencyContextError;
+declare function isError(result: GetDependencyContextResult): result is GetDependencyContextError;
+export interface PackageResolverLike {
+    resolve(packageName: string): Promise<{
+        success: boolean;
+        packagePath: string | undefined;
+        metadata: {
+            name: string;
+            version: string;
+            description: string | undefined;
+            typesPath: string | undefined;
+            mainPath: string | undefined;
+            exportMap: Record<string, string>;
+            dependencies: Record<string, string>;
+            devDependencies: Record<string, string>;
+            repository: string | undefined;
+        } | undefined;
+        error: string | undefined;
+    }>;
+    findTypesEntry(packagePath: string, metadata: {
+        typesPath: string | undefined;
+        exportMap: Record<string, string>;
+    }): Promise<string | undefined>;
+}
+export interface GetDependencyContextDeps {
+    cache: CacheManager;
+    resolver: PackageResolverLike;
+    config: Config;
+}
+/**
+ * Creates the get_dependency_context tool handler
+ */
+export declare function createGetDependencyContextHandler(deps: GetDependencyContextDeps): (input: GetDependencyContextInput) => Promise<GetDependencyContextResult>;
+export { isError };
+//# sourceMappingURL=get-dependency.d.ts.map

package/dist/tools/get-dependency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-dependency.d.ts","sourceRoot":"","sources":["../../src/tools/get-dependency.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAOjD,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,mBAAmB,CAAA;CACrD;AAED,MAAM,MAAM,0BAA0B,GAAG,0BAA0B,GAAG,yBAAyB,CAAA;AAE/F,iBAAS,OAAO,CAAC,MAAM,EAAE,0BAA0B,GAAG,MAAM,IAAI,yBAAyB,CAExF;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QACpC,OAAO,EAAE,OAAO,CAAA;QAChB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;QAC/B,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM,CAAA;YACZ,OAAO,EAAE,MAAM,CAAA;YACf,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;YAC/B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;YAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;YAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YACpC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YACvC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;SAC/B,GAAG,SAAS,CAAA;QACb,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;KAC1B,CAAC,CAAA;IACF,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE;QAC5C,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;QAC7B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAClC,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,YAAY,CAAA;IACnB,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,wBAAwB,IAE5E,OAAO,yBAAyB,KAC/B,OAAO,CAAC,0BAA0B,CAAC,CAmGvC;AAED,OAAO,EAAE,OAAO,EAAE,CAAA"}

package/dist/tools/get-dependency.js

@@ -0,0 +1,105 @@
+/**
+ * MCP Tool: get_dependency_context
+ *
+ * Retrieves API context for an installed dependency.
+ * Checks cache first, generates snapshot on miss.
+ */
+import { extract, followReExports } from '../extraction/typescript.js';
+import { createExternalPackageResolver } from '../extraction/external-resolver.js';
+import { generateSnapshot } from '../extraction/snapshot.js';
+import { extractReadme } from '../extraction/readme.js';
+import { extractExamples, associateExamples, filterRelevantExamples } from '../extraction/examples.js';
+function isError(result) {
+    return 'error' in result;
+}
+/**
+ * Creates the get_dependency_context tool handler
+ */
+export function createGetDependencyContextHandler(deps) {
+    return async function getDependencyContext(input) {
+        const { packageName } = input;
+        const { cache, resolver, config } = deps;
+        // First, resolve the package to get version
+        const resolved = await resolver.resolve(packageName);
+        if (!resolved.success || !resolved.metadata) {
+            return {
+                error: `Package '${packageName}' not found in node_modules`,
+                code: 'NOT_FOUND'
+            };
+        }
+        const { metadata, packagePath } = resolved;
+        const version = metadata.version;
+        // Check cache
+        const cached = await cache.get(packageName, version);
+        if (cached) {
+            return {
+                snapshot: cached.content,
+                cached: true,
+                version
+            };
+        }
+        // Use types path from metadata (already resolved by resolver.resolve())
+        const typesPath = metadata.typesPath;
+        if (!typesPath) {
+            return {
+                error: `No TypeScript declarations found for '${packageName}'`,
+                code: 'NO_TYPES'
+            };
+        }
+        // Create external resolver for following external package re-exports
+        const externalResolver = createExternalPackageResolver(config.projectRoot);
+        // Extract types
+        let extraction = await extract(typesPath);
+        // Follow re-exports and import-then-export patterns
+        if (extraction.reExports.length > 0 || extraction.importedExports.length > 0) {
+            extraction = await followReExports(extraction, typesPath, new Set(), { externalResolver });
+        }
+        if (extraction.functions.length === 0 &&
+            extraction.classes.length === 0 &&
+            extraction.interfaces.length === 0 &&
+            extraction.types.length === 0) {
+            // Check if there were only errors
+            if (extraction.errors.length > 0) {
+                return {
+                    error: `Failed to extract types from '${packageName}': ${extraction.errors.join(', ')}`,
+                    code: 'EXTRACTION_FAILED'
+                };
+            }
+        }
+        // Extract README if configured
+        let readme = undefined;
+        if (config.extraction.includeReadme) {
+            readme = await extractReadme(packagePath, config.extraction.maxReadmeLength);
+        }
+        // Extract and associate examples from README
+        let examples = [];
+        if (config.extraction.includeExamples && readme) {
+            const allExportNames = [
+                ...extraction.functions.map(f => f.name),
+                ...extraction.classes.map(c => c.name),
+                ...extraction.interfaces.map(i => i.name),
+                ...extraction.types.map(t => t.name)
+            ];
+            const rawExamples = extractExamples(readme.raw);
+            const associated = associateExamples(rawExamples, allExportNames);
+            examples = filterRelevantExamples(associated, config.extraction.maxExamples);
+        }
+        // Generate snapshot
+        const snapshot = generateSnapshot(metadata, extraction, readme, {
+            includeReadme: config.extraction.includeReadme,
+            includeJsDoc: config.extraction.includeJsDoc,
+            includeExamples: config.extraction.includeExamples,
+            maxReadmeLength: config.extraction.maxReadmeLength,
+            maxExamples: config.extraction.maxExamples
+        }, examples);
+        // Store in cache
+        await cache.set(snapshot);
+        return {
+            snapshot: snapshot.content,
+            cached: false,
+            version
+        };
+    };
+}
+export { isError };
+//# sourceMappingURL=get-dependency.js.map

package/dist/tools/get-dependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-dependency.js","sourceRoot":"","sources":["../../src/tools/get-dependency.ts"],"names":[],"mappings":"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"}

package/dist/tools/index-dependencies.d.ts

@@ -0,0 +1,51 @@
+/**
+ * MCP Tool: index_dependencies
+ *
+ * Builds or refreshes the vector search index for dependencies.
+ */
+import type { VectorIndexManager } from '../vector/index-manager.js';
+import type { CacheManager } from '../cache/manager.js';
+import type { PackageResolverLike } from './get-dependency.js';
+import type { Config } from '../config/loader.js';
+export interface IndexDependenciesInput {
+    packages?: string[];
+}
+export interface IndexDependenciesOutput {
+    indexed: number;
+    failed: string[];
+    duration: number;
+    message: string;
+}
+export interface IndexDependenciesDeps {
+    indexManager: VectorIndexManager | null;
+    cache: CacheManager;
+    resolver: PackageResolverLike;
+    config: Config;
+    listDependencies: () => Promise<{
+        name: string;
+        version: string;
+    }[]>;
+}
+/**
+ * Creates the index_dependencies tool handler
+ */
+export declare function createIndexDependenciesHandler(deps: IndexDependenciesDeps): (input: IndexDependenciesInput) => Promise<IndexDependenciesOutput>;
+/** Tool definition for MCP */
+export declare const indexDependenciesToolDef: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            packages: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+//# sourceMappingURL=index-dependencies.d.ts.map

package/dist/tools/index-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-dependencies.d.ts","sourceRoot":"","sources":["../../src/tools/index-dependencies.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAIjD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAA;IACvC,KAAK,EAAE,YAAY,CAAA;IACnB,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,EAAE,MAAM,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAA;CACrE;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,qBAAqB,IAEtE,OAAO,sBAAsB,KAC5B,OAAO,CAAC,uBAAuB,CAAC,CAoEpC;AAED,8BAA8B;AAC9B,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;CAcpC,CAAA"}

package/dist/tools/index-dependencies.js

@@ -0,0 +1,90 @@
+/**
+ * MCP Tool: index_dependencies
+ *
+ * Builds or refreshes the vector search index for dependencies.
+ */
+import { extract, followReExports } from '../extraction/typescript.js';
+import { createExternalPackageResolver } from '../extraction/external-resolver.js';
+/**
+ * Creates the index_dependencies tool handler
+ */
+export function createIndexDependenciesHandler(deps) {
+    return async function indexDependencies(input) {
+        const { indexManager, resolver, config, listDependencies } = deps;
+        const start = Date.now();
+        if (!indexManager) {
+            return {
+                indexed: 0,
+                failed: [],
+                duration: 0,
+                message: 'Vector search is not enabled. Configure vectorSearch in config to enable indexing.'
+            };
+        }
+        // Get packages to index
+        let packages;
+        if (input.packages && input.packages.length > 0) {
+            packages = [];
+            for (const name of input.packages) {
+                const resolved = await resolver.resolve(name);
+                if (resolved.success && resolved.metadata) {
+                    packages.push({ name, version: resolved.metadata.version });
+                }
+            }
+        }
+        else {
+            packages = await listDependencies();
+        }
+        const failed = [];
+        let indexed = 0;
+        for (const pkg of packages) {
+            try {
+                // Skip if already indexed with same version
+                if (indexManager.isPackageIndexed(pkg.name, pkg.version)) {
+                    continue;
+                }
+                const resolved = await resolver.resolve(pkg.name);
+                if (!resolved.success || !resolved.metadata || !resolved.packagePath) {
+                    failed.push(pkg.name);
+                    continue;
+                }
+                const typesPath = resolved.metadata.typesPath;
+                if (!typesPath) {
+                    continue; // Skip packages without types
+                }
+                const externalResolver = createExternalPackageResolver(config.nodeModulesPath);
+                const extraction = await extract(typesPath);
+                const withReExports = await followReExports(extraction, typesPath, new Set(), { externalResolver });
+                const count = await indexManager.indexPackage(pkg.name, pkg.version, withReExports);
+                if (count > 0)
+                    indexed++;
+            }
+            catch {
+                failed.push(pkg.name);
+            }
+        }
+        const duration = Date.now() - start;
+        return {
+            indexed,
+            failed,
+            duration,
+            message: `Indexed ${indexed} package(s) in ${duration}ms${failed.length > 0 ? `. Failed: ${failed.join(', ')}` : ''}`
+        };
+    };
+}
+/** Tool definition for MCP */
+export const indexDependenciesToolDef = {
+    name: 'index_dependencies',
+    description: 'Build or refresh the vector search index for semantic code search. Indexes type information from dependencies.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            packages: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Specific packages to index. If omitted, indexes all dependencies.'
+            }
+        },
+        required: []
+    }
+};
+//# sourceMappingURL=index-dependencies.js.map