dep-context-mcp 1.0.0

package/dist/vector/chunker.js

@@ -0,0 +1,205 @@
+/**
+ * Semantic chunker - breaks extracted API info into embeddable chunks
+ */
+// Rough token estimate: ~4 chars per token
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+// Track used IDs to handle overloads
+const usedIds = new Map();
+function createChunkId(packageName, contentType, name) {
+    const baseId = `${packageName}:${contentType}:${name}`;
+    const count = usedIds.get(baseId) || 0;
+    usedIds.set(baseId, count + 1);
+    return count === 0 ? baseId : `${baseId}:${count}`;
+}
+function resetIdTracking() {
+    usedIds.clear();
+}
+function findExampleForExport(name, examples) {
+    return examples.find(e => e.associatedExports.includes(name));
+}
+function formatFunctionChunk(fn, example) {
+    const lines = [
+        `Function: ${fn.name}`,
+        '',
+        `Signature: ${fn.signature}`,
+    ];
+    if (fn.jsDoc) {
+        lines.push('', fn.jsDoc);
+    }
+    if (fn.parameters.length > 0) {
+        lines.push('', 'Parameters:');
+        for (const p of fn.parameters) {
+            const opt = p.optional ? ' (optional)' : '';
+            lines.push(`  - ${p.name}: ${p.type}${opt}`);
+        }
+    }
+    lines.push('', `Returns: ${fn.returnType}`);
+    if (example) {
+        lines.push('', 'Example:', '```', example.code, '```');
+    }
+    return lines.join('\n');
+}
+function formatClassChunk(cls) {
+    const lines = [
+        `Class: ${cls.name}`,
+    ];
+    if (cls.jsDoc) {
+        lines.push('', cls.jsDoc);
+    }
+    if (cls.constructorSignature) {
+        lines.push('', `Constructor: ${cls.constructorSignature}`);
+    }
+    if (cls.properties.length > 0) {
+        lines.push('', 'Properties:');
+        for (const p of cls.properties) {
+            const ro = p.readonly ? 'readonly ' : '';
+            const opt = p.optional ? '?' : '';
+            lines.push(`  - ${ro}${p.name}${opt}: ${p.type}`);
+        }
+    }
+    if (cls.methods.length > 0) {
+        lines.push('', `Methods: ${cls.methods.map(m => m.name).join(', ')}`);
+    }
+    return lines.join('\n');
+}
+function formatMethodChunk(cls, method) {
+    const staticPrefix = method.isStatic ? 'static ' : '';
+    const asyncPrefix = method.isAsync ? 'async ' : '';
+    return [
+        `Method: ${cls.name}.${method.name}`,
+        '',
+        `Signature: ${staticPrefix}${asyncPrefix}${method.signature}`,
+        method.jsDoc ? `\n${method.jsDoc}` : ''
+    ].filter(Boolean).join('\n');
+}
+function formatInterfaceChunk(iface) {
+    const lines = [
+        `Interface: ${iface.name}`,
+    ];
+    if (iface.jsDoc) {
+        lines.push('', iface.jsDoc);
+    }
+    if (iface.properties.length > 0) {
+        lines.push('', 'Properties:');
+        for (const p of iface.properties) {
+            const ro = p.readonly ? 'readonly ' : '';
+            const opt = p.optional ? '?' : '';
+            lines.push(`  - ${ro}${p.name}${opt}: ${p.type}`);
+        }
+    }
+    if (iface.methods.length > 0) {
+        lines.push('', 'Methods:');
+        for (const m of iface.methods) {
+            lines.push(`  - ${m.signature}`);
+        }
+    }
+    return lines.join('\n');
+}
+function formatTypeChunk(type) {
+    const lines = [
+        `Type: ${type.name}`,
+        '',
+        `Definition: ${type.definition}`,
+    ];
+    if (type.jsDoc) {
+        lines.push('', type.jsDoc);
+    }
+    return lines.join('\n');
+}
+/**
+ * Chunks extraction results into embeddable pieces
+ */
+export function chunkExtraction(extraction, options) {
+    const { packageName, version, maxTokens = 500, examples = [] } = options;
+    const chunks = [];
+    // Reset ID tracking for this extraction
+    resetIdTracking();
+    // Chunk functions
+    for (const fn of extraction.functions) {
+        const example = findExampleForExport(fn.name, examples);
+        const content = formatFunctionChunk(fn, example);
+        chunks.push({
+            id: createChunkId(packageName, 'function', fn.name),
+            content,
+            metadata: {
+                packageName,
+                version,
+                contentType: 'function',
+                name: fn.name,
+                signature: fn.signature
+            }
+        });
+    }
+    // Chunk classes
+    for (const cls of extraction.classes) {
+        // Class overview chunk
+        const classContent = formatClassChunk(cls);
+        chunks.push({
+            id: createChunkId(packageName, 'class', cls.name),
+            content: classContent,
+            metadata: {
+                packageName,
+                version,
+                contentType: 'class',
+                name: cls.name,
+                signature: cls.constructorSignature
+            }
+        });
+        // Individual method chunks for large methods
+        for (const method of cls.methods) {
+            const methodContent = formatMethodChunk(cls, method);
+            if (estimateTokens(methodContent) > 100) { // Only chunk substantial methods
+                chunks.push({
+                    id: createChunkId(packageName, 'method', `${cls.name}.${method.name}`),
+                    content: methodContent,
+                    metadata: {
+                        packageName,
+                        version,
+                        contentType: 'method',
+                        name: `${cls.name}.${method.name}`,
+                        signature: method.signature
+                    }
+                });
+            }
+        }
+    }
+    // Chunk interfaces
+    for (const iface of extraction.interfaces) {
+        const content = formatInterfaceChunk(iface);
+        // Skip very large interfaces (likely internal)
+        if (estimateTokens(content) > maxTokens * 2)
+            continue;
+        chunks.push({
+            id: createChunkId(packageName, 'interface', iface.name),
+            content,
+            metadata: {
+                packageName,
+                version,
+                contentType: 'interface',
+                name: iface.name
+            }
+        });
+    }
+    // Chunk types
+    for (const type of extraction.types) {
+        const content = formatTypeChunk(type);
+        // Skip very large type definitions
+        if (estimateTokens(content) > maxTokens * 2)
+            continue;
+        chunks.push({
+            id: createChunkId(packageName, 'type', type.name),
+            content,
+            metadata: {
+                packageName,
+                version,
+                contentType: 'type',
+                name: type.name,
+                signature: type.definition
+            }
+        });
+    }
+    return chunks;
+}
+//# sourceMappingURL=chunker.js.map

package/dist/vector/chunker.js.map

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

package/dist/vector/embeddings.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Embedding providers - abstractions for generating text embeddings
+ */
+export interface EmbeddingProvider {
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+    readonly dimensions: number;
+}
+export interface OpenAIConfig {
+    apiKey: string;
+    model?: 'text-embedding-3-small' | 'text-embedding-3-large';
+    baseUrl?: string;
+}
+export interface OllamaConfig {
+    model?: string;
+    baseUrl?: string;
+}
+/**
+ * OpenAI embedding provider
+ */
+export declare function createOpenAIProvider(config: OpenAIConfig): EmbeddingProvider;
+/**
+ * Ollama embedding provider
+ */
+export declare function createOllamaProvider(config?: OllamaConfig): EmbeddingProvider;
+export type ProviderType = 'openai' | 'ollama';
+export interface CreateProviderOptions {
+    type: ProviderType;
+    openai?: OpenAIConfig;
+    ollama?: OllamaConfig;
+}
+/**
+ * Factory function to create embedding provider
+ */
+export declare function createEmbeddingProvider(options: CreateProviderOptions): EmbeddingProvider;
+//# sourceMappingURL=embeddings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/vector/embeddings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACtC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,wBAAwB,GAAG,wBAAwB,CAAA;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,iBAAiB,CAkD5E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,YAAiB,GAAG,iBAAiB,CAyCjF;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE9C,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,YAAY,CAAA;IAClB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,qBAAqB,GAAG,iBAAiB,CAazF"}

package/dist/vector/embeddings.js

@@ -0,0 +1,106 @@
+/**
+ * Embedding providers - abstractions for generating text embeddings
+ */
+/**
+ * OpenAI embedding provider
+ */
+export function createOpenAIProvider(config) {
+    const model = config.model ?? 'text-embedding-3-small';
+    const baseUrl = config.baseUrl ?? 'https://api.openai.com/v1';
+    const dimensions = model === 'text-embedding-3-large' ? 3072 : 1536;
+    async function embed(text) {
+        const result = await embedBatch([text]);
+        return result[0];
+    }
+    async function embedBatch(texts) {
+        let response;
+        try {
+            response = await fetch(`${baseUrl}/embeddings`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${config.apiKey}`
+                },
+                body: JSON.stringify({
+                    model,
+                    input: texts
+                })
+            });
+        }
+        catch (err) {
+            throw new Error(`OpenAI API not reachable. Check your network connection.`);
+        }
+        if (!response.ok) {
+            const error = await response.text();
+            if (response.status === 401) {
+                throw new Error(`OpenAI API key invalid or expired. Check your OPENAI_API_KEY.`);
+            }
+            if (response.status === 429) {
+                throw new Error(`OpenAI rate limit exceeded. Wait and retry.`);
+            }
+            throw new Error(`OpenAI error: ${response.status} ${error}`);
+        }
+        const data = await response.json();
+        // Sort by index to maintain order
+        return data.data
+            .sort((a, b) => a.index - b.index)
+            .map(d => d.embedding);
+    }
+    return { embed, embedBatch, dimensions };
+}
+/**
+ * Ollama embedding provider
+ */
+export function createOllamaProvider(config = {}) {
+    const model = config.model ?? 'nomic-embed-text';
+    const baseUrl = config.baseUrl ?? 'http://localhost:11434';
+    // nomic-embed-text produces 768-dim vectors
+    const dimensions = model === 'nomic-embed-text' ? 768 : 768;
+    async function embed(text) {
+        let response;
+        try {
+            response = await fetch(`${baseUrl}/api/embeddings`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ model, prompt: text })
+            });
+        }
+        catch (err) {
+            throw new Error(`Ollama not responding at ${baseUrl}. Is Ollama running? Try: ollama serve`);
+        }
+        if (!response.ok) {
+            const error = await response.text();
+            if (response.status === 404) {
+                throw new Error(`Ollama model '${model}' not found. Try: ollama pull ${model}`);
+            }
+            throw new Error(`Ollama error: ${response.status} ${error}`);
+        }
+        const data = await response.json();
+        return data.embedding;
+    }
+    async function embedBatch(texts) {
+        // Ollama doesn't support batch, so we do sequential calls
+        const results = [];
+        for (const text of texts) {
+            results.push(await embed(text));
+        }
+        return results;
+    }
+    return { embed, embedBatch, dimensions };
+}
+/**
+ * Factory function to create embedding provider
+ */
+export function createEmbeddingProvider(options) {
+    if (options.type === 'openai') {
+        if (!options.openai?.apiKey) {
+            throw new Error('OpenAI API key required');
+        }
+        return createOpenAIProvider(options.openai);
+    }
+    if (options.type === 'ollama') {
+        return createOllamaProvider(options.ollama);
+    }
+    throw new Error(`Unknown provider type: ${options.type}`);
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/vector/embeddings.js.map

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

package/dist/vector/file-store.d.ts

@@ -0,0 +1,10 @@
+/**
+ * File-based vector storage - no external dependencies
+ * Uses brute-force cosine similarity (fine for <10k vectors)
+ */
+import type { VectorStore } from './chroma.js';
+export interface FileStoreConfig {
+    path: string;
+}
+export declare function createFileStore(config: FileStoreConfig): Promise<VectorStore>;
+//# sourceMappingURL=file-store.d.ts.map

package/dist/vector/file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.d.ts","sourceRoot":"","sources":["../../src/vector/file-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,WAAW,EAA8C,MAAM,aAAa,CAAA;AAuB1F,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAsEnF"}

package/dist/vector/file-store.js

@@ -0,0 +1,80 @@
+/**
+ * File-based vector storage - no external dependencies
+ * Uses brute-force cosine similarity (fine for <10k vectors)
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { dirname } from 'node:path';
+function cosineSimilarity(a, b) {
+    let dot = 0, normA = 0, normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    return dot / (Math.sqrt(normA) * Math.sqrt(normB));
+}
+export async function createFileStore(config) {
+    const filePath = config.path;
+    let data = { documents: [] };
+    // Load existing data
+    if (existsSync(filePath)) {
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            data = JSON.parse(content);
+        }
+        catch {
+            data = { documents: [] };
+        }
+    }
+    async function save() {
+        await mkdir(dirname(filePath), { recursive: true });
+        await writeFile(filePath, JSON.stringify(data));
+    }
+    async function add(docs) {
+        if (docs.length === 0)
+            return;
+        for (const doc of docs) {
+            const existing = data.documents.findIndex(d => d.id === doc.id);
+            if (existing >= 0) {
+                data.documents[existing] = doc;
+            }
+            else {
+                data.documents.push(doc);
+            }
+        }
+        await save();
+    }
+    async function search(embedding, options = {}) {
+        let docs = data.documents;
+        // Apply filters
+        if (options.packageName) {
+            docs = docs.filter(d => d.metadata.packageName === options.packageName);
+        }
+        if (options.contentType) {
+            docs = docs.filter(d => d.metadata.contentType === options.contentType);
+        }
+        // Calculate similarities and sort
+        const scored = docs.map(d => ({
+            ...d,
+            score: 1 - cosineSimilarity(embedding, d.embedding) // Lower = better (like ChromaDB distance)
+        }));
+        scored.sort((a, b) => a.score - b.score);
+        return scored.slice(0, options.limit ?? 10).map(d => ({
+            id: d.id,
+            content: d.content,
+            score: d.score,
+            metadata: d.metadata
+        }));
+    }
+    async function removeByPackage(packageName) {
+        data.documents = data.documents.filter(d => d.metadata.packageName !== packageName);
+        await save();
+    }
+    async function clear() {
+        data.documents = [];
+        await save();
+    }
+    return { add, search, removeByPackage, clear };
+}
+//# sourceMappingURL=file-store.js.map

package/dist/vector/file-store.js.map

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

package/dist/vector/index-manager.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Vector index manager - orchestrates chunking, embedding, and storage
+ */
+import { EmbeddingProvider } from './embeddings.js';
+import { VectorStore } from './chroma.js';
+import { ExtractionResult } from '../extraction/typescript.js';
+export interface IndexedPackage {
+    packageName: string;
+    version: string;
+    chunkCount: number;
+    indexedAt: Date;
+}
+export interface SearchResult {
+    packageName: string;
+    name: string;
+    contentType: string;
+    signature?: string;
+    content: string;
+    score: number;
+}
+export interface IndexStatus {
+    packages: IndexedPackage[];
+    totalChunks: number;
+}
+export interface VectorIndexManager {
+    indexPackage(packageName: string, version: string, extraction: ExtractionResult): Promise<number>;
+    search(query: string, options?: {
+        limit?: number;
+        packageName?: string;
+    }): Promise<SearchResult[]>;
+    removePackage(packageName: string): Promise<void>;
+    getStatus(): IndexStatus;
+    isPackageIndexed(packageName: string, version: string): boolean;
+}
+export interface IndexManagerOptions {
+    fallbackPath?: string;
+}
+export declare function createVectorIndexManager(embeddings: EmbeddingProvider, initialStore: VectorStore, options?: IndexManagerOptions): VectorIndexManager;
+//# sourceMappingURL=index-manager.d.ts.map

package/dist/vector/index-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-manager.d.ts","sourceRoot":"","sources":["../../src/vector/index-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,WAAW,EAAiB,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAI9D,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACjG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAClG,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,SAAS,IAAI,WAAW,CAAA;IACxB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;CAChE;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,iBAAiB,EAC7B,YAAY,EAAE,WAAW,EACzB,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CAmHpB"}

package/dist/vector/index-manager.js

@@ -0,0 +1,105 @@
+/**
+ * Vector index manager - orchestrates chunking, embedding, and storage
+ */
+import { chunkExtraction } from './chunker.js';
+import { createFileStore } from './file-store.js';
+import { logger } from '../utils/logger.js';
+export function createVectorIndexManager(embeddings, initialStore, options = {}) {
+    const indexed = new Map();
+    let store = initialStore;
+    let usingFallback = false;
+    async function switchToFallback() {
+        if (usingFallback)
+            return;
+        const fallbackPath = options.fallbackPath ?? '.cache/dep-context/vectors/index.json';
+        logger.warn('Primary storage failed, switching to file-based fallback', { path: fallbackPath });
+        store = await createFileStore({ path: fallbackPath });
+        usingFallback = true;
+        indexed.clear(); // Clear in-memory state, will rebuild via auto-index
+    }
+    async function indexPackage(packageName, version, extraction) {
+        const chunks = chunkExtraction(extraction, { packageName, version });
+        if (chunks.length === 0)
+            return 0;
+        // Generate embeddings in batches
+        const batchSize = 50;
+        const docs = [];
+        for (let i = 0; i < chunks.length; i += batchSize) {
+            const batch = chunks.slice(i, i + batchSize);
+            const embeddings_batch = await embeddings.embedBatch(batch.map(c => c.content));
+            batch.forEach((chunk, j) => {
+                docs.push({
+                    id: chunk.id,
+                    content: chunk.content,
+                    embedding: embeddings_batch[j],
+                    metadata: chunk.metadata
+                });
+            });
+        }
+        // Remove old chunks for this package first, then add new
+        try {
+            await store.removeByPackage(packageName);
+            await store.add(docs);
+        }
+        catch (err) {
+            await switchToFallback();
+            await store.removeByPackage(packageName);
+            await store.add(docs);
+        }
+        indexed.set(packageName, {
+            packageName,
+            version,
+            chunkCount: chunks.length,
+            indexedAt: new Date()
+        });
+        return chunks.length;
+    }
+    async function search(query, options = {}) {
+        const queryEmbedding = await embeddings.embed(query);
+        let results;
+        try {
+            results = await store.search(queryEmbedding, {
+                limit: options.limit ?? 10,
+                packageName: options.packageName
+            });
+        }
+        catch (err) {
+            await switchToFallback();
+            results = await store.search(queryEmbedding, {
+                limit: options.limit ?? 10,
+                packageName: options.packageName
+            });
+        }
+        return results.map(r => ({
+            packageName: r.metadata.packageName,
+            name: r.metadata.name,
+            contentType: r.metadata.contentType,
+            signature: r.metadata.signature,
+            content: r.content,
+            score: r.score
+        }));
+    }
+    async function removePackage(packageName) {
+        try {
+            await store.removeByPackage(packageName);
+        }
+        catch (err) {
+            await switchToFallback();
+            await store.removeByPackage(packageName);
+        }
+        indexed.delete(packageName);
+    }
+    function getStatus() {
+        const packages = Array.from(indexed.values());
+        return {
+            packages,
+            totalChunks: packages.reduce((sum, p) => sum + p.chunkCount, 0)
+        };
+    }
+    function isPackageIndexed(packageName, version) {
+        const pkg = indexed.get(packageName);
+        return pkg?.version === version;
+    }
+    return { indexPackage, search, removePackage, getStatus, isPackageIndexed };
+}
+//# sourceMappingURL=index-manager.js.map

package/dist/vector/index-manager.js.map

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

package/dist/vector/provider-factory.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Embedding provider factory - auto-detects available providers
+ */
+import type { EmbeddingProvider } from './embeddings.js';
+export interface EmbeddingConfig {
+    provider: 'openai' | 'ollama';
+    ollama?: {
+        baseUrl?: string;
+        model?: string;
+    };
+    openai?: {
+        apiKey?: string;
+        model?: 'text-embedding-3-small' | 'text-embedding-3-large';
+        baseUrl?: string;
+    };
+}
+export interface ProviderResult {
+    provider: EmbeddingProvider | null;
+    name: string;
+    message: string;
+}
+export declare function createEmbeddingProviderAuto(config: EmbeddingConfig): Promise<ProviderResult>;
+//# sourceMappingURL=provider-factory.d.ts.map

package/dist/vector/provider-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-factory.d.ts","sourceRoot":"","sources":["../../src/vector/provider-factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAGxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAC7B,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,wBAAwB,GAAG,wBAAwB,CAAA;QAC3D,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;CACF;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAaD,wBAAsB,2BAA2B,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAoClG"}