dep-context-mcp 1.0.0

package/dist/tools/search-codebase.js

@@ -0,0 +1,117 @@
+/**
+ * MCP Tool: search_codebase
+ *
+ * Semantic search across indexed dependencies using vector embeddings.
+ * Auto-indexes on first search if no index exists.
+ */
+import { logger } from '../utils/logger.js';
+import { extract, followReExports } from '../extraction/typescript.js';
+import { createExternalPackageResolver } from '../extraction/external-resolver.js';
+/**
+ * Auto-index production dependencies
+ */
+async function autoIndex(deps) {
+    const { indexManager, resolver, config, listProductionDeps } = deps;
+    if (!indexManager)
+        return { indexed: 0, failed: [] };
+    const packages = await listProductionDeps();
+    const failed = [];
+    let indexed = 0;
+    for (const pkg of packages) {
+        try {
+            if (indexManager.isPackageIndexed(pkg.name, pkg.version))
+                continue;
+            const resolved = await resolver.resolve(pkg.name);
+            if (!resolved.success || !resolved.metadata?.typesPath)
+                continue;
+            const externalResolver = createExternalPackageResolver(config.nodeModulesPath);
+            const extraction = await extract(resolved.metadata.typesPath);
+            const withReExports = await followReExports(extraction, resolved.metadata.typesPath, new Set(), { externalResolver });
+            const count = await indexManager.indexPackage(pkg.name, pkg.version, withReExports);
+            if (count > 0)
+                indexed++;
+        }
+        catch {
+            failed.push(pkg.name);
+        }
+    }
+    return { indexed, failed };
+}
+/**
+ * Creates the search_codebase tool handler
+ */
+export function createSearchCodebaseHandler(deps) {
+    return async function searchCodebase(input) {
+        const { indexManager } = deps;
+        const start = performance.now();
+        if (!indexManager) {
+            return {
+                results: [],
+                totalIndexed: 0,
+                message: 'Vector search is not enabled. Configure vectorSearch in config to enable semantic search.'
+            };
+        }
+        let status = indexManager.getStatus();
+        let autoIndexed = false;
+        // Auto-index if no packages indexed yet
+        if (status.totalChunks === 0) {
+            logger.debug('No index found, auto-indexing production dependencies');
+            const indexStart = performance.now();
+            const result = await autoIndex(deps);
+            autoIndexed = result.indexed > 0;
+            logger.debug('Auto-indexing complete', {
+                indexed: result.indexed,
+                failed: result.failed.length,
+                durationMs: Math.round(performance.now() - indexStart)
+            });
+            status = indexManager.getStatus();
+        }
+        if (status.totalChunks === 0) {
+            return {
+                results: [],
+                totalIndexed: 0,
+                message: 'No packages with type definitions found to index.'
+            };
+        }
+        const searchStart = performance.now();
+        const results = await indexManager.search(input.query, {
+            limit: input.limit ?? 10,
+            packageName: input.packageName
+        });
+        logger.debug('Search complete', {
+            query: input.query,
+            results: results.length,
+            searchMs: Math.round(performance.now() - searchStart),
+            totalMs: Math.round(performance.now() - start)
+        });
+        return {
+            results,
+            totalIndexed: status.totalChunks,
+            autoIndexed: autoIndexed || undefined
+        };
+    };
+}
+/** Tool definition for MCP */
+export const searchCodebaseToolDef = {
+    name: 'search_codebase',
+    description: 'Search installed package APIs by natural language. Use BEFORE implementing features to find relevant functions. Auto-indexes on first use. Examples: "validation utilities", "date formatting", "HTTP client methods"',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Natural language description of what you\'re looking for (e.g., "function to debounce calls")'
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum results to return (default: 10)'
+            },
+            packageName: {
+                type: 'string',
+                description: 'Optional: limit search to a specific package when user explicitly names one'
+            }
+        },
+        required: ['query']
+    }
+};
+//# sourceMappingURL=search-codebase.js.map

package/dist/tools/search-codebase.js.map

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

package/dist/tools/search.d.ts

@@ -0,0 +1,37 @@
+/**
+ * MCP Tool: search_dependencies
+ *
+ * Text-based search across installed dependencies.
+ * Searches package names and descriptions with relevance scoring.
+ */
+export interface SearchDependenciesInput {
+    query: string;
+    limit?: number;
+}
+export interface SearchResult {
+    packageName: string;
+    version: string;
+    description: string | undefined;
+    score: number;
+    matchType: 'exact' | 'prefix' | 'contains' | 'description';
+}
+export interface SearchDependenciesOutput {
+    results: SearchResult[];
+    totalMatches: number;
+    query: string;
+}
+export interface PackageResolverLike {
+    listAllDependencies(includeDev?: boolean): Promise<Array<{
+        name: string;
+        version: string;
+        description: string | undefined;
+    }>>;
+}
+export interface SearchDependenciesDeps {
+    resolver: PackageResolverLike;
+}
+/**
+ * Creates the search_dependencies tool handler
+ */
+export declare function createSearchDependenciesHandler(deps: SearchDependenciesDeps): (input: SearchDependenciesInput) => Promise<SearchDependenciesOutput>;
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,CAAA;CAC3D;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,mBAAmB,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC;QACvD,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;KAChC,CAAC,CAAC,CAAA;CACJ;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,mBAAmB,CAAA;CAC9B;AA2CD;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,sBAAsB,IAExE,OAAO,uBAAuB,KAC7B,OAAO,CAAC,wBAAwB,CAAC,CAyCrC"}

package/dist/tools/search.js

@@ -0,0 +1,77 @@
+/**
+ * MCP Tool: search_dependencies
+ *
+ * Text-based search across installed dependencies.
+ * Searches package names and descriptions with relevance scoring.
+ */
+/**
+ * Calculates relevance score for a package match
+ *
+ * Scoring:
+ * - Exact name match: 1.0
+ * - Name starts with query: 0.9
+ * - Name contains query: 0.7
+ * - Description contains query: 0.5
+ */
+function calculateScore(packageName, description, query) {
+    const lowerName = packageName.toLowerCase();
+    const lowerQuery = query.toLowerCase();
+    const lowerDesc = description?.toLowerCase() ?? '';
+    // Exact match
+    if (lowerName === lowerQuery) {
+        return { score: 1.0, matchType: 'exact' };
+    }
+    // Name starts with query
+    if (lowerName.startsWith(lowerQuery)) {
+        return { score: 0.9, matchType: 'prefix' };
+    }
+    // Name contains query
+    if (lowerName.includes(lowerQuery)) {
+        return { score: 0.7, matchType: 'contains' };
+    }
+    // Description contains query
+    if (lowerDesc.includes(lowerQuery)) {
+        return { score: 0.5, matchType: 'description' };
+    }
+    return null;
+}
+/**
+ * Creates the search_dependencies tool handler
+ */
+export function createSearchDependenciesHandler(deps) {
+    return async function searchDependencies(input) {
+        const { query, limit = 10 } = input;
+        const { resolver } = deps;
+        // Get all dependencies
+        const dependencies = await resolver.listAllDependencies(true);
+        // Score and filter matches
+        const matches = [];
+        for (const dep of dependencies) {
+            const result = calculateScore(dep.name, dep.description, query);
+            if (result) {
+                matches.push({
+                    packageName: dep.name,
+                    version: dep.version,
+                    description: dep.description,
+                    score: result.score,
+                    matchType: result.matchType
+                });
+            }
+        }
+        // Sort by score (descending), then by name (ascending)
+        matches.sort((a, b) => {
+            if (b.score !== a.score) {
+                return b.score - a.score;
+            }
+            return a.packageName.localeCompare(b.packageName);
+        });
+        // Apply limit
+        const results = matches.slice(0, limit);
+        return {
+            results,
+            totalMatches: matches.length,
+            query
+        };
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiCH;;;;;;;;GAQG;AACH,SAAS,cAAc,CACrB,WAAmB,EACnB,WAA+B,EAC/B,KAAa;IAEb,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,EAAE,CAAA;IAC3C,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAA;IACtC,MAAM,SAAS,GAAG,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;IAElD,cAAc;IACd,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QAC7B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,CAAA;IAC3C,CAAC;IAED,yBAAyB;IACzB,IAAI,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;IAC5C,CAAC;IAED,sBAAsB;IACtB,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,CAAA;IAC9C,CAAC;IAED,6BAA6B;IAC7B,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,aAAa,EAAE,CAAA;IACjD,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAAC,IAA4B;IAC1E,OAAO,KAAK,UAAU,kBAAkB,CACtC,KAA8B;QAE9B,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,KAAK,CAAA;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAA;QAEzB,uBAAuB;QACvB,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAA;QAE7D,2BAA2B;QAC3B,MAAM,OAAO,GAAmB,EAAE,CAAA;QAElC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;YAE/D,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC;oBACX,WAAW,EAAE,GAAG,CAAC,IAAI;oBACrB,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,WAAW,EAAE,GAAG,CAAC,WAAW;oBAC5B,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,SAAS,EAAE,MAAM,CAAC,SAAS;iBAC5B,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAED,uDAAuD;QACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACpB,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;gBACxB,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;YAC1B,CAAC;YACD,OAAO,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;QACnD,CAAC,CAAC,CAAA;QAEF,cAAc;QACd,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;QAEvC,OAAO;YACL,OAAO;YACP,YAAY,EAAE,OAAO,CAAC,MAAM;YAC5B,KAAK;SACN,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Simple logger with level support
+ * Logs to stderr so MCP clients can capture
+ */
+export type LogLevel = 'error' | 'warn' | 'info' | 'debug' | 'trace';
+export declare function setLogLevel(level: LogLevel): void;
+export declare function getLogLevel(): LogLevel;
+export declare const logger: {
+    error(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    debug(message: string, data?: Record<string, unknown>): void;
+    trace(message: string, data?: Record<string, unknown>): void;
+    /** Log with timing info */
+    timed<T>(label: string, fn: () => T): T;
+    /** Log async with timing info */
+    timedAsync<T>(label: string, fn: () => Promise<T>): Promise<T>;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;AAYpE,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAcD,eAAO,MAAM,MAAM;mBACF,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;kBAG9C,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;kBAG7C,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;mBAG5C,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;mBAG7C,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,2BAA2B;UACrB,CAAC,SAAS,MAAM,MAAM,MAAM,CAAC,GAAG,CAAC;IASvC,iCAAiC;eAChB,CAAC,SAAS,MAAM,MAAM,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAQrE,CAAA"}

package/dist/utils/logger.js

@@ -0,0 +1,71 @@
+/**
+ * Simple logger with level support
+ * Logs to stderr so MCP clients can capture
+ */
+const LEVELS = {
+    error: 0,
+    warn: 1,
+    info: 2,
+    debug: 3,
+    trace: 4
+};
+let currentLevel = process.env.LOG_LEVEL || 'info';
+export function setLogLevel(level) {
+    currentLevel = level;
+}
+export function getLogLevel() {
+    return currentLevel;
+}
+function shouldLog(level) {
+    return LEVELS[level] <= LEVELS[currentLevel];
+}
+function formatMessage(level, message, data) {
+    const prefix = `[dep-context] [${level.toUpperCase()}]`;
+    if (data) {
+        return `${prefix} ${message} ${JSON.stringify(data)}`;
+    }
+    return `${prefix} ${message}`;
+}
+export const logger = {
+    error(message, data) {
+        if (shouldLog('error'))
+            console.error(formatMessage('error', message, data));
+    },
+    warn(message, data) {
+        if (shouldLog('warn'))
+            console.error(formatMessage('warn', message, data));
+    },
+    info(message, data) {
+        if (shouldLog('info'))
+            console.error(formatMessage('info', message, data));
+    },
+    debug(message, data) {
+        if (shouldLog('debug'))
+            console.error(formatMessage('debug', message, data));
+    },
+    trace(message, data) {
+        if (shouldLog('trace'))
+            console.error(formatMessage('trace', message, data));
+    },
+    /** Log with timing info */
+    timed(label, fn) {
+        if (!shouldLog('debug'))
+            return fn();
+        const start = performance.now();
+        const result = fn();
+        const duration = Math.round(performance.now() - start);
+        console.error(formatMessage('debug', `${label} completed`, { durationMs: duration }));
+        return result;
+    },
+    /** Log async with timing info */
+    async timedAsync(label, fn) {
+        if (!shouldLog('debug'))
+            return fn();
+        const start = performance.now();
+        const result = await fn();
+        const duration = Math.round(performance.now() - start);
+        console.error(formatMessage('debug', `${label} completed`, { durationMs: duration }));
+        return result;
+    }
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/vector/chroma.d.ts

@@ -0,0 +1,38 @@
+/**
+ * ChromaDB integration for vector storage and search
+ */
+export interface ChunkDocument {
+    id: string;
+    content: string;
+    embedding: number[];
+    metadata: {
+        packageName: string;
+        version: string;
+        contentType: string;
+        name: string;
+        signature?: string;
+    };
+}
+export interface SearchResult {
+    id: string;
+    content: string;
+    score: number;
+    metadata: ChunkDocument['metadata'];
+}
+export interface SearchOptions {
+    limit?: number;
+    packageName?: string;
+    contentType?: string;
+}
+export interface VectorStore {
+    add(docs: ChunkDocument[]): Promise<void>;
+    search(embedding: number[], options?: SearchOptions): Promise<SearchResult[]>;
+    removeByPackage(packageName: string): Promise<void>;
+    clear(): Promise<void>;
+}
+export interface ChromaConfig {
+    host?: string;
+    collectionName?: string;
+}
+export declare function createChromaStore(config?: ChromaConfig): Promise<VectorStore>;
+//# sourceMappingURL=chroma.d.ts.map

package/dist/vector/chroma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chroma.d.ts","sourceRoot":"","sources":["../../src/vector/chroma.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,QAAQ,EAAE;QACR,WAAW,EAAE,MAAM,CAAA;QACnB,OAAO,EAAE,MAAM,CAAA;QACf,WAAW,EAAE,MAAM,CAAA;QACnB,IAAI,EAAE,MAAM,CAAA;QACZ,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;CACF;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAC7E,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,wBAAsB,iBAAiB,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAmEvF"}

package/dist/vector/chroma.js

@@ -0,0 +1,69 @@
+/**
+ * ChromaDB integration for vector storage and search
+ */
+import { ChromaClient } from 'chromadb';
+export async function createChromaStore(config = {}) {
+    // Use ephemeral (in-memory) if no host specified
+    const client = config.host
+        ? new ChromaClient({ path: config.host })
+        : new ChromaClient();
+    const collectionName = config.collectionName ?? 'dep-context';
+    let collection;
+    try {
+        collection = await client.getOrCreateCollection({ name: collectionName });
+    }
+    catch (err) {
+        const host = config.host ?? 'localhost:8000';
+        throw new Error(`ChromaDB not available at ${host}. Is it running? Try: docker run -d -p 8000:8000 chromadb/chroma`);
+    }
+    async function add(docs) {
+        if (docs.length === 0)
+            return;
+        try {
+            await collection.upsert({
+                ids: docs.map(d => d.id),
+                embeddings: docs.map(d => d.embedding),
+                documents: docs.map(d => d.content),
+                metadatas: docs.map(d => d.metadata)
+            });
+        }
+        catch (err) {
+            throw new Error(`ChromaDB write failed: ${err.message}. Is ChromaDB still running?`);
+        }
+    }
+    async function search(embedding, options = {}) {
+        const where = {};
+        if (options.packageName)
+            where.packageName = options.packageName;
+        if (options.contentType)
+            where.contentType = options.contentType;
+        let results;
+        try {
+            results = await collection.query({
+                queryEmbeddings: [embedding],
+                nResults: options.limit ?? 10,
+                where: Object.keys(where).length > 0 ? where : undefined
+            });
+        }
+        catch (err) {
+            throw new Error(`ChromaDB query failed: ${err.message}. Is ChromaDB still running?`);
+        }
+        if (!results.ids[0])
+            return [];
+        return results.ids[0].map((id, i) => ({
+            id,
+            content: results.documents[0]?.[i] ?? '',
+            score: results.distances?.[0]?.[i] ?? 0,
+            metadata: results.metadatas[0]?.[i]
+        }));
+    }
+    async function removeByPackage(packageName) {
+        await collection.delete({ where: { packageName } });
+    }
+    async function clear() {
+        await client.deleteCollection({ name: collectionName });
+        collection = await client.createCollection({ name: collectionName });
+    }
+    return { add, search, removeByPackage, clear };
+}
+//# sourceMappingURL=chroma.js.map

package/dist/vector/chroma.js.map

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

package/dist/vector/chunker.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Semantic chunker - breaks extracted API info into embeddable chunks
+ */
+import type { ExtractionResult } from '../extraction/typescript.js';
+import type { CodeExample } from '../extraction/examples.js';
+export interface ChunkMetadata {
+    packageName: string;
+    version: string;
+    contentType: 'function' | 'class' | 'method' | 'interface' | 'type';
+    name: string;
+    signature?: string;
+    importPath?: string;
+}
+export interface Chunk {
+    id: string;
+    content: string;
+    metadata: ChunkMetadata;
+}
+export interface ChunkerOptions {
+    packageName: string;
+    version: string;
+    maxTokens?: number;
+    examples?: CodeExample[];
+}
+/**
+ * Chunks extraction results into embeddable pieces
+ */
+export declare function chunkExtraction(extraction: ExtractionResult, options: ChunkerOptions): Chunk[];
+//# sourceMappingURL=chunker.d.ts.map

package/dist/vector/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../src/vector/chunker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAKjB,MAAM,6BAA6B,CAAA;AACpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAE5D,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAA;IACnE,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,aAAa,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;CACzB;AAwID;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,cAAc,GAAG,KAAK,EAAE,CAoG9F"}