tea-rags 0.9.0

package/build/core/adapters/embeddings/openai.js

@@ -0,0 +1,99 @@
+import Bottleneck from "bottleneck";
+import OpenAI from "openai";
+import { getModelDimensions } from "./utils/model-dimensions.js";
+export class OpenAIEmbeddings {
+    client;
+    model;
+    dimensions;
+    limiter;
+    retryAttempts;
+    retryDelayMs;
+    constructor(apiKey, model = "text-embedding-3-small", dimensions, rateLimitConfig) {
+        this.client = new OpenAI({ apiKey });
+        this.model = model;
+        this.dimensions = dimensions || getModelDimensions(model) || 1536;
+        // Rate limiting configuration
+        const maxRequestsPerMinute = rateLimitConfig?.maxRequestsPerMinute || 3500;
+        this.retryAttempts = rateLimitConfig?.retryAttempts || 3;
+        this.retryDelayMs = rateLimitConfig?.retryDelayMs || 1000;
+        // Initialize bottleneck limiter
+        // Uses reservoir (token bucket) pattern for burst handling with per-minute refresh
+        // Note: Using both reservoir and minTime provides defense in depth but may be
+        // more conservative than necessary. Future optimization could use reservoir-only
+        // for better burst handling or minTime-only for simpler even distribution.
+        this.limiter = new Bottleneck({
+            reservoir: maxRequestsPerMinute,
+            reservoirRefreshAmount: maxRequestsPerMinute,
+            reservoirRefreshInterval: 60 * 1000, // 1 minute
+            maxConcurrent: 10,
+            minTime: Math.floor((60 * 1000) / maxRequestsPerMinute),
+        });
+    }
+    async retryWithBackoff(fn, attempt = 0) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            const apiError = error;
+            const isRateLimitError = apiError?.status === 429 ||
+                apiError?.code === "rate_limit_exceeded" ||
+                apiError?.message?.toLowerCase().includes("rate limit");
+            if (isRateLimitError && attempt < this.retryAttempts) {
+                // Check for Retry-After header (different HTTP clients may nest differently)
+                const retryAfter = apiError?.response?.headers?.["retry-after"] || apiError?.headers?.["retry-after"];
+                let delayMs;
+                if (retryAfter) {
+                    // Use Retry-After header if available (in seconds)
+                    const parsed = parseInt(retryAfter, 10);
+                    delayMs = !isNaN(parsed) && parsed > 0 ? parsed * 1000 : this.retryDelayMs * Math.pow(2, attempt);
+                }
+                else {
+                    // Exponential backoff: 1s, 2s, 4s, 8s...
+                    delayMs = this.retryDelayMs * Math.pow(2, attempt);
+                }
+                const waitTimeSeconds = (delayMs / 1000).toFixed(1);
+                console.error(`Rate limit reached. Retrying in ${waitTimeSeconds}s (attempt ${attempt + 1}/${this.retryAttempts})...`);
+                await new Promise((resolve) => setTimeout(resolve, delayMs));
+                return this.retryWithBackoff(fn, attempt + 1);
+            }
+            // If not a rate limit error or max retries exceeded, throw
+            if (isRateLimitError) {
+                throw new Error(`OpenAI API rate limit exceeded after ${this.retryAttempts} retry attempts. Please try again later or reduce request frequency.`);
+            }
+            throw error;
+        }
+    }
+    async embed(text) {
+        return this.limiter.schedule(async () => this.retryWithBackoff(async () => {
+            const response = await this.client.embeddings.create({
+                model: this.model,
+                input: text,
+                dimensions: this.dimensions,
+            });
+            return {
+                embedding: response.data[0].embedding,
+                dimensions: this.dimensions,
+            };
+        }));
+    }
+    async embedBatch(texts) {
+        return this.limiter.schedule(async () => this.retryWithBackoff(async () => {
+            const response = await this.client.embeddings.create({
+                model: this.model,
+                input: texts,
+                dimensions: this.dimensions,
+            });
+            return response.data.map((item) => ({
+                embedding: item.embedding,
+                dimensions: this.dimensions,
+            }));
+        }));
+    }
+    getDimensions() {
+        return this.dimensions;
+    }
+    getModel() {
+        return this.model;
+    }
+}
+//# sourceMappingURL=openai.js.map

package/build/core/adapters/embeddings/openai.js.map

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

package/build/core/adapters/embeddings/sparse.d.ts

@@ -0,0 +1,40 @@
+/**
+ * BM25 Sparse Vector Generator
+ *
+ * This module provides a simple BM25-like sparse vector generation for keyword search.
+ * For production use, consider using a proper BM25 implementation or Qdrant's built-in
+ * sparse vector generation via FastEmbed.
+ */
+import type { SparseVector } from "../qdrant/client.js";
+export declare class BM25SparseVectorGenerator {
+    private readonly vocabulary;
+    private readonly idfScores;
+    private documentCount;
+    private readonly k1;
+    private readonly b;
+    constructor(k1?: number, b?: number);
+    /**
+     * Tokenize text into words (simple whitespace tokenization + lowercase)
+     */
+    private tokenize;
+    /**
+     * Calculate term frequency for a document
+     */
+    private getTermFrequency;
+    /**
+     * Build vocabulary from training documents (optional pre-training step)
+     * In a simple implementation, we can skip this and use on-the-fly vocabulary
+     */
+    train(documents: string[]): void;
+    /**
+     * Generate sparse vector for a query or document
+     * Returns indices and values for non-zero dimensions
+     */
+    generate(text: string, avgDocLength?: number): SparseVector;
+    /**
+     * Simple static method for generating sparse vectors without training
+     * Useful for quick implementation
+     */
+    static generateSimple(text: string): SparseVector;
+}
+//# sourceMappingURL=sparse.d.ts.map

package/build/core/adapters/embeddings/sparse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sparse.d.ts","sourceRoot":"","sources":["../../../../src/core/adapters/embeddings/sparse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMxD,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAS;gBAEf,EAAE,SAAM,EAAE,CAAC,SAAO;IAQ9B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAQhB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAwBhC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,SAAK,GAAG,YAAY;IAoCvD;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;CAIlD"}

package/build/core/adapters/embeddings/sparse.js

@@ -0,0 +1,107 @@
+/**
+ * BM25 Sparse Vector Generator
+ *
+ * This module provides a simple BM25-like sparse vector generation for keyword search.
+ * For production use, consider using a proper BM25 implementation or Qdrant's built-in
+ * sparse vector generation via FastEmbed.
+ */
+export class BM25SparseVectorGenerator {
+    vocabulary;
+    idfScores;
+    documentCount;
+    k1;
+    b;
+    constructor(k1 = 1.2, b = 0.75) {
+        this.vocabulary = new Map();
+        this.idfScores = new Map();
+        this.documentCount = 0;
+        this.k1 = k1;
+        this.b = b;
+    }
+    /**
+     * Tokenize text into words (simple whitespace tokenization + lowercase)
+     */
+    tokenize(text) {
+        return text
+            .toLowerCase()
+            .replace(/[^\w\s]/g, " ")
+            .split(/\s+/)
+            .filter((token) => token.length > 0);
+    }
+    /**
+     * Calculate term frequency for a document
+     */
+    getTermFrequency(tokens) {
+        const tf = {};
+        for (const token of tokens) {
+            tf[token] = (tf[token] || 0) + 1;
+        }
+        return tf;
+    }
+    /**
+     * Build vocabulary from training documents (optional pre-training step)
+     * In a simple implementation, we can skip this and use on-the-fly vocabulary
+     */
+    train(documents) {
+        this.documentCount = documents.length;
+        const documentFrequency = new Map();
+        // Calculate document frequency for each term
+        for (const doc of documents) {
+            const tokens = this.tokenize(doc);
+            const uniqueTokens = new Set(tokens);
+            for (const token of uniqueTokens) {
+                if (!this.vocabulary.has(token)) {
+                    this.vocabulary.set(token, this.vocabulary.size);
+                }
+                documentFrequency.set(token, (documentFrequency.get(token) || 0) + 1);
+            }
+        }
+        // Calculate IDF scores
+        for (const [token, df] of documentFrequency.entries()) {
+            const idf = Math.log((this.documentCount - df + 0.5) / (df + 0.5) + 1.0);
+            this.idfScores.set(token, idf);
+        }
+    }
+    /**
+     * Generate sparse vector for a query or document
+     * Returns indices and values for non-zero dimensions
+     */
+    generate(text, avgDocLength = 50) {
+        const tokens = this.tokenize(text);
+        const tf = this.getTermFrequency(tokens);
+        const docLength = tokens.length;
+        const indices = [];
+        const values = [];
+        // Calculate BM25 score for each term
+        for (const [token, freq] of Object.entries(tf)) {
+            // Ensure token is in vocabulary
+            if (!this.vocabulary.has(token)) {
+                // For unseen tokens, add them to vocabulary dynamically
+                this.vocabulary.set(token, this.vocabulary.size);
+            }
+            const index = this.vocabulary.get(token);
+            if (index === undefined)
+                continue;
+            // Use a default IDF if not trained
+            const idf = this.idfScores.get(token) || 1.0;
+            // BM25 formula
+            const numerator = freq * (this.k1 + 1);
+            const denominator = freq + this.k1 * (1 - this.b + this.b * (docLength / avgDocLength));
+            const score = idf * (numerator / denominator);
+            if (score > 0) {
+                indices.push(index);
+                values.push(score);
+            }
+        }
+        return { indices, values };
+    }
+    /**
+     * Simple static method for generating sparse vectors without training
+     * Useful for quick implementation
+     */
+    static generateSimple(text) {
+        const generator = new BM25SparseVectorGenerator();
+        return generator.generate(text);
+    }
+}
+//# sourceMappingURL=sparse.js.map

package/build/core/adapters/embeddings/sparse.js.map

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

package/build/core/adapters/embeddings/utils/model-dimensions.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Provider-agnostic model → dimensions registry.
+ *
+ * Single source of truth for default embedding dimensions.
+ * Quantization suffixes (-fp16, -fp32, -q8, etc.) are stripped before lookup
+ * because they don't affect vector dimensionality.
+ */
+/** Strip quantization suffix (-fp16, -fp32, -q8, -q8_0, etc.) from a model name. */
+export declare function stripQuantizationSuffix(model: string): string;
+/**
+ * Look up default dimensions for a known model.
+ * Tries exact match first, then strips quantization suffix and retries.
+ * Returns `undefined` for unknown models.
+ */
+export declare function getModelDimensions(model: string): number | undefined;
+//# sourceMappingURL=model-dimensions.d.ts.map

package/build/core/adapters/embeddings/utils/model-dimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-dimensions.d.ts","sourceRoot":"","sources":["../../../../../src/core/adapters/embeddings/utils/model-dimensions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6CH,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpE"}

package/build/core/adapters/embeddings/utils/model-dimensions.js

@@ -0,0 +1,57 @@
+/**
+ * Provider-agnostic model → dimensions registry.
+ *
+ * Single source of truth for default embedding dimensions.
+ * Quantization suffixes (-fp16, -fp32, -q8, etc.) are stripped before lookup
+ * because they don't affect vector dimensionality.
+ */
+const MODEL_DIMENSIONS = {
+    // ── OpenAI ──
+    "text-embedding-3-small": 1536,
+    "text-embedding-3-large": 3072,
+    "text-embedding-ada-002": 1536,
+    // ── Cohere ──
+    "embed-english-v3.0": 1024,
+    "embed-multilingual-v3.0": 1024,
+    "embed-english-light-v3.0": 384,
+    "embed-multilingual-light-v3.0": 384,
+    // ── Voyage ──
+    "voyage-2": 1024,
+    "voyage-large-2": 1536,
+    "voyage-code-2": 1536,
+    "voyage-code-3": 1024,
+    "voyage-3-large": 1024,
+    "voyage-lite-02-instruct": 1024,
+    "voyage-4": 1024,
+    "voyage-3.5": 1024,
+    "voyage-4-lite": 512,
+    "voyage-3.5-lite": 512,
+    // ── Ollama ──
+    "nomic-embed-text": 768,
+    "mxbai-embed-large": 1024,
+    "all-minilm": 384,
+    "jina-embeddings-v2-base-code": 768,
+    "unclemusclez/jina-embeddings-v2-base-code:latest": 768,
+    // ── HuggingFace / ONNX ──
+    "jinaai/jina-embeddings-v2-base-code": 768,
+    "nomic-ai/nomic-embed-text-v1.5": 768,
+    "Xenova/all-MiniLM-L6-v2": 384,
+    "Xenova/bge-base-en-v1.5": 768,
+    "Xenova/multilingual-e5-base": 768,
+    "BAAI/bge-small-en-v1.5": 384,
+};
+/** Regex matching quantization suffixes: -fp16, -fp32, -q4, -q8, -q8_0, etc. */
+const QUANT_SUFFIX = /-(fp16|fp32|q\d+[_\d]*)$/;
+/** Strip quantization suffix (-fp16, -fp32, -q8, -q8_0, etc.) from a model name. */
+export function stripQuantizationSuffix(model) {
+    return model.replace(QUANT_SUFFIX, "");
+}
+/**
+ * Look up default dimensions for a known model.
+ * Tries exact match first, then strips quantization suffix and retries.
+ * Returns `undefined` for unknown models.
+ */
+export function getModelDimensions(model) {
+    return MODEL_DIMENSIONS[model] ?? MODEL_DIMENSIONS[stripQuantizationSuffix(model)];
+}
+//# sourceMappingURL=model-dimensions.js.map

package/build/core/adapters/embeddings/utils/model-dimensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-dimensions.js","sourceRoot":"","sources":["../../../../../src/core/adapters/embeddings/utils/model-dimensions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,gBAAgB,GAA2B;IAC/C,eAAe;IACf,wBAAwB,EAAE,IAAI;IAC9B,wBAAwB,EAAE,IAAI;IAC9B,wBAAwB,EAAE,IAAI;IAE9B,eAAe;IACf,oBAAoB,EAAE,IAAI;IAC1B,yBAAyB,EAAE,IAAI;IAC/B,0BAA0B,EAAE,GAAG;IAC/B,+BAA+B,EAAE,GAAG;IAEpC,eAAe;IACf,UAAU,EAAE,IAAI;IAChB,gBAAgB,EAAE,IAAI;IACtB,eAAe,EAAE,IAAI;IACrB,eAAe,EAAE,IAAI;IACrB,gBAAgB,EAAE,IAAI;IACtB,yBAAyB,EAAE,IAAI;IAC/B,UAAU,EAAE,IAAI;IAChB,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,GAAG;IACpB,iBAAiB,EAAE,GAAG;IAEtB,eAAe;IACf,kBAAkB,EAAE,GAAG;IACvB,mBAAmB,EAAE,IAAI;IACzB,YAAY,EAAE,GAAG;IACjB,8BAA8B,EAAE,GAAG;IACnC,kDAAkD,EAAE,GAAG;IAEvD,2BAA2B;IAC3B,qCAAqC,EAAE,GAAG;IAC1C,gCAAgC,EAAE,GAAG;IACrC,yBAAyB,EAAE,GAAG;IAC9B,yBAAyB,EAAE,GAAG;IAC9B,6BAA6B,EAAE,GAAG;IAClC,wBAAwB,EAAE,GAAG;CAC9B,CAAC;AAEF,gFAAgF;AAChF,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEhD,oFAAoF;AACpF,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,OAAO,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,gBAAgB,CAAC,KAAK,CAAC,IAAI,gBAAgB,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC;AACrF,CAAC"}

package/build/core/adapters/embeddings/voyage.d.ts

@@ -0,0 +1,19 @@
+import type { EmbeddingProvider, EmbeddingResult, RateLimitConfig } from "./base.js";
+export declare class VoyageEmbeddings implements EmbeddingProvider {
+    private readonly apiKey;
+    private readonly model;
+    private readonly dimensions;
+    private readonly limiter;
+    private readonly retryAttempts;
+    private readonly retryDelayMs;
+    private readonly baseUrl;
+    private readonly inputType?;
+    constructor(apiKey: string, model?: string, dimensions?: number, rateLimitConfig?: RateLimitConfig, baseUrl?: string, inputType?: "query" | "document");
+    private retryWithBackoff;
+    private callApi;
+    embed(text: string): Promise<EmbeddingResult>;
+    embedBatch(texts: string[]): Promise<EmbeddingResult[]>;
+    getDimensions(): number;
+    getModel(): string;
+}
+//# sourceMappingURL=voyage.d.ts.map

package/build/core/adapters/embeddings/voyage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voyage.d.ts","sourceRoot":"","sources":["../../../../src/core/adapters/embeddings/voyage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAgBrF,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAuB;gBAGhD,MAAM,EAAE,MAAM,EACd,KAAK,SAAa,EAClB,UAAU,CAAC,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,eAAe,EACjC,OAAO,SAAgC,EACvC,SAAS,CAAC,EAAE,OAAO,GAAG,UAAU;YAuBpB,gBAAgB;YA4BhB,OAAO;IA2Bf,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAiB7C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAiB7D,aAAa,IAAI,MAAM;IAIvB,QAAQ,IAAI,MAAM;CAGnB"}

package/build/core/adapters/embeddings/voyage.js

@@ -0,0 +1,103 @@
+import Bottleneck from "bottleneck";
+import { getModelDimensions } from "./utils/model-dimensions.js";
+export class VoyageEmbeddings {
+    apiKey;
+    model;
+    dimensions;
+    limiter;
+    retryAttempts;
+    retryDelayMs;
+    baseUrl;
+    inputType;
+    constructor(apiKey, model = "voyage-2", dimensions, rateLimitConfig, baseUrl = "https://api.voyageai.com/v1", inputType) {
+        this.apiKey = apiKey;
+        this.model = model;
+        this.baseUrl = baseUrl;
+        this.inputType = inputType;
+        this.dimensions = dimensions || getModelDimensions(model) || 1024;
+        // Rate limiting configuration
+        const maxRequestsPerMinute = rateLimitConfig?.maxRequestsPerMinute || 300;
+        this.retryAttempts = rateLimitConfig?.retryAttempts || 3;
+        this.retryDelayMs = rateLimitConfig?.retryDelayMs || 1000;
+        this.limiter = new Bottleneck({
+            reservoir: maxRequestsPerMinute,
+            reservoirRefreshAmount: maxRequestsPerMinute,
+            reservoirRefreshInterval: 60 * 1000,
+            maxConcurrent: 5,
+            minTime: Math.floor((60 * 1000) / maxRequestsPerMinute),
+        });
+    }
+    async retryWithBackoff(fn, attempt = 0) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            const apiError = error;
+            const isRateLimitError = apiError?.status === 429 || apiError?.message?.toLowerCase().includes("rate limit");
+            if (isRateLimitError && attempt < this.retryAttempts) {
+                const delayMs = this.retryDelayMs * Math.pow(2, attempt);
+                const waitTimeSeconds = (delayMs / 1000).toFixed(1);
+                console.error(`Rate limit reached. Retrying in ${waitTimeSeconds}s (attempt ${attempt + 1}/${this.retryAttempts})...`);
+                await new Promise((resolve) => setTimeout(resolve, delayMs));
+                return this.retryWithBackoff(fn, attempt + 1);
+            }
+            if (isRateLimitError) {
+                throw new Error(`Voyage AI API rate limit exceeded after ${this.retryAttempts} retry attempts. Please try again later or reduce request frequency.`);
+            }
+            throw error;
+        }
+    }
+    async callApi(texts) {
+        const body = {
+            input: texts,
+            model: this.model,
+        };
+        if (this.inputType) {
+            body.input_type = this.inputType;
+        }
+        const response = await fetch(`${this.baseUrl}/embeddings`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Voyage AI API error (${response.status}): ${errorText}`);
+        }
+        return response.json();
+    }
+    async embed(text) {
+        return this.limiter.schedule(async () => this.retryWithBackoff(async () => {
+            const response = await this.callApi([text]);
+            if (!response.data || response.data.length === 0) {
+                throw new Error("No embedding returned from Voyage AI API");
+            }
+            return {
+                embedding: response.data[0].embedding,
+                dimensions: this.dimensions,
+            };
+        }));
+    }
+    async embedBatch(texts) {
+        return this.limiter.schedule(async () => this.retryWithBackoff(async () => {
+            const response = await this.callApi(texts);
+            if (!response.data) {
+                throw new Error("No embeddings returned from Voyage AI API");
+            }
+            return response.data.map((item) => ({
+                embedding: item.embedding,
+                dimensions: this.dimensions,
+            }));
+        }));
+    }
+    getDimensions() {
+        return this.dimensions;
+    }
+    getModel() {
+        return this.model;
+    }
+}
+//# sourceMappingURL=voyage.js.map

package/build/core/adapters/embeddings/voyage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voyage.js","sourceRoot":"","sources":["../../../../src/core/adapters/embeddings/voyage.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AAGpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAejE,MAAM,OAAO,gBAAgB;IACV,MAAM,CAAS;IACf,KAAK,CAAS;IACd,UAAU,CAAS;IACnB,OAAO,CAAa;IACpB,aAAa,CAAS;IACtB,YAAY,CAAS;IACrB,OAAO,CAAS;IAChB,SAAS,CAAwB;IAElD,YACE,MAAc,EACd,KAAK,GAAG,UAAU,EAClB,UAAmB,EACnB,eAAiC,EACjC,OAAO,GAAG,6BAA6B,EACvC,SAAgC;QAEhC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI,kBAAkB,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;QAElE,8BAA8B;QAC9B,MAAM,oBAAoB,GAAG,eAAe,EAAE,oBAAoB,IAAI,GAAG,CAAC;QAC1E,IAAI,CAAC,aAAa,GAAG,eAAe,EAAE,aAAa,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,YAAY,GAAG,eAAe,EAAE,YAAY,IAAI,IAAI,CAAC;QAE1D,IAAI,CAAC,OAAO,GAAG,IAAI,UAAU,CAAC;YAC5B,SAAS,EAAE,oBAAoB;YAC/B,sBAAsB,EAAE,oBAAoB;YAC5C,wBAAwB,EAAE,EAAE,GAAG,IAAI;YACnC,aAAa,EAAE,CAAC;YAChB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,oBAAoB,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAI,EAAoB,EAAE,OAAO,GAAG,CAAC;QACjE,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,KAAoB,CAAC;YACtC,MAAM,gBAAgB,GAAG,QAAQ,EAAE,MAAM,KAAK,GAAG,IAAI,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YAE7G,IAAI,gBAAgB,IAAI,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;gBACrD,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;gBACzD,MAAM,eAAe,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACpD,OAAO,CAAC,KAAK,CACX,mCAAmC,eAAe,cAAc,OAAO,GAAG,CAAC,IAAI,IAAI,CAAC,aAAa,MAAM,CACxG,CAAC;gBAEF,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC7D,OAAO,IAAI,CAAC,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;YAChD,CAAC;YAED,IAAI,gBAAgB,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CACb,2CAA2C,IAAI,CAAC,aAAa,sEAAsE,CACpI,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,KAAe;QACnC,MAAM,IAAI,GAA4B;YACpC,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;QAEF,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;QACnC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,aAAa,EAAE;YACzD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aACvC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAkC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CACtC,IAAI,CAAC,gBAAgB,CAAC,KAAK,IAAI,EAAE;YAC/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAE5C,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;YAC9D,CAAC;YAED,OAAO;gBACL,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;gBACrC,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC;QACJ,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CACtC,IAAI,CAAC,gBAAgB,CAAC,KAAK,IAAI,EAAE;YAC/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAE3C,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC/D,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAClC,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC,CAAC,CAAC;QACN,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}

package/build/core/adapters/git/client.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Low-level git operations — CLI primary, isomorphic-git for individual object reads.
+ * No enrichment concepts, no caching logic.
+ *
+ * Heavy operations (log walking, tree diffing) use CLI exclusively to avoid OOM
+ * on large repos. isomorphic-git is used only for individual object reads
+ * (readBlob, readCommit, resolveRef) where pack cache growth is bounded.
+ */
+import type { CommitInfo, FileChurnData } from "./types.js";
+/** Race a promise against a timeout. Rejects with Error(message) on expiry. */
+export declare function withTimeout<T>(promise: Promise<T>, ms: number, message: string): Promise<T>;
+/** Run `git log` with pathspec filtering, return raw stdout. */
+export declare function execFileForPathspec(repoRoot: string, args: string[], timeoutMs: number): Promise<string>;
+/** Build CLI args for `git log --numstat`. Uses HEAD (not --all), no --max-count. */
+export declare function buildCliArgs(sinceDate?: Date): string[];
+/** Resolve HEAD SHA — isomorphic-git first, CLI fallback. */
+export declare function getHead(repoRoot: string): Promise<string>;
+/** Resolve git repo root from a path. Returns absolutePath if not a git repo. */
+export declare function resolveRepoRoot(absolutePath: string): string;
+/** Run CLI `git log --numstat` and parse output into FileChurnData map. */
+export declare function buildViaCli(repoRoot: string, sinceDate?: Date, timeoutMs?: number): Promise<Map<string, FileChurnData>>;
+/** Read a blob at a specific commit as a UTF-8 string. Returns "" if missing. */
+export declare function readBlobAsString(repoRoot: string, commitOid: string, filepath: string, cache: Record<string, unknown>): Promise<string>;
+/** Run a single pathspec-filtered git log and parse the output. */
+export declare function getCommitsByPathspecSingle(repoRoot: string, sinceDate: Date, filePaths: string[], timeoutMs?: number): Promise<{
+    commit: CommitInfo;
+    changedFiles: string[];
+}[]>;
+/**
+ * Run multiple pathspec CLI calls in batches, merge results by commit SHA.
+ * Same commit may appear in multiple batches (touched files in different batches).
+ */
+export declare function getCommitsByPathspecBatched(repoRoot: string, sinceDate: Date, filePaths: string[], timeoutMs?: number): Promise<{
+    commit: CommitInfo;
+    changedFiles: string[];
+}[]>;
+/**
+ * Get commits touching specific files via CLI pathspec filtering.
+ * Dispatches to single or batched depending on count.
+ */
+export declare function getCommitsByPathspec(repoRoot: string, sinceDate: Date, filePaths: string[], timeoutMs?: number): Promise<{
+    commit: CommitInfo;
+    changedFiles: string[];
+}[]>;
+//# sourceMappingURL=client.d.ts.map

package/build/core/adapters/git/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/core/adapters/git/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAM5D,+EAA+E;AAC/E,wBAAsB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAgBjG;AAID,gEAAgE;AAChE,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO9G;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,EAAE,CAMvD;AAED,6DAA6D;AAC7D,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO/D;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAS5D;AAED,2EAA2E;AAC3E,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,IAAI,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAQrC;AAMD,iFAAiF;AACjF,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC,CAajB;AAMD,mEAAmE;AACnE,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,IAAI,EACf,SAAS,EAAE,MAAM,EAAE,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,CAAC,CAa3D;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,IAAI,EACf,SAAS,EAAE,MAAM,EAAE,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,CAAC,CA2C3D;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,IAAI,EACf,SAAS,EAAE,MAAM,EAAE,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,CAAC,CAQ3D"}