glancey 2.0.0

package/dist/embeddings/rate-limiter.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Token bucket rate limiter for API requests
+ * Implements a classic token bucket algorithm with configurable rate and burst capacity
+ */
+/**
+ * Configuration options for the rate limiter
+ */
+export interface RateLimiterConfig {
+    /** Maximum requests per second (tokens added per second) */
+    requestsPerSecond: number;
+    /** Maximum burst capacity (bucket size) */
+    burstCapacity?: number;
+}
+/**
+ * Default rate limiter configuration
+ * Conservative default suitable for most API rate limits
+ */
+export declare const DEFAULT_RATE_LIMITER_CONFIG: Required<RateLimiterConfig>;
+/**
+ * Token bucket rate limiter
+ *
+ * The token bucket algorithm works as follows:
+ * - Tokens are added to the bucket at a fixed rate (requestsPerSecond)
+ * - Each request consumes one token
+ * - If no tokens are available, the request waits until one becomes available
+ * - The bucket has a maximum capacity (burstCapacity) to allow short bursts
+ */
+export declare class RateLimiter {
+    private tokens;
+    private lastRefillTime;
+    private readonly requestsPerSecond;
+    private readonly burstCapacity;
+    private pendingQueue;
+    private scheduledTimeout;
+    constructor(config?: RateLimiterConfig);
+    /**
+     * Refill tokens based on elapsed time
+     */
+    private refillTokens;
+    /**
+     * Calculate wait time until a token is available
+     */
+    private getWaitTimeMs;
+    /**
+     * Schedule processing of the queue if not already scheduled
+     */
+    private scheduleProcessing;
+    /**
+     * Process the pending queue
+     */
+    private processQueue;
+    /**
+     * Acquire a token, waiting if necessary
+     * Returns a promise that resolves when a token is acquired
+     */
+    acquire(): Promise<void>;
+    /**
+     * Try to acquire a token without waiting
+     * Returns true if a token was acquired, false otherwise
+     */
+    tryAcquire(): boolean;
+    /**
+     * Get the current number of available tokens
+     */
+    getAvailableTokens(): number;
+    /**
+     * Get the current queue length
+     */
+    getQueueLength(): number;
+    /**
+     * Reset the rate limiter to initial state
+     */
+    reset(): void;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/embeddings/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/embeddings/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,iBAAiB,CAGnE,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,gBAAgB,CAA8C;gBAE1D,MAAM,CAAC,EAAE,iBAAiB;IAQtC;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAe9B;;;OAGG;IACH,UAAU,IAAI,OAAO;IAWrB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAK5B;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,KAAK,IAAI,IAAI;CAcd"}

package/dist/embeddings/rate-limiter.js

@@ -0,0 +1,145 @@
+/**
+ * Token bucket rate limiter for API requests
+ * Implements a classic token bucket algorithm with configurable rate and burst capacity
+ */
+/**
+ * Default rate limiter configuration
+ * Conservative default suitable for most API rate limits
+ */
+export const DEFAULT_RATE_LIMITER_CONFIG = {
+    requestsPerSecond: 5,
+    burstCapacity: 10,
+};
+/**
+ * Token bucket rate limiter
+ *
+ * The token bucket algorithm works as follows:
+ * - Tokens are added to the bucket at a fixed rate (requestsPerSecond)
+ * - Each request consumes one token
+ * - If no tokens are available, the request waits until one becomes available
+ * - The bucket has a maximum capacity (burstCapacity) to allow short bursts
+ */
+export class RateLimiter {
+    tokens;
+    lastRefillTime;
+    requestsPerSecond;
+    burstCapacity;
+    pendingQueue = [];
+    scheduledTimeout = null;
+    constructor(config) {
+        const opts = { ...DEFAULT_RATE_LIMITER_CONFIG, ...config };
+        this.requestsPerSecond = opts.requestsPerSecond;
+        this.burstCapacity = opts.burstCapacity;
+        this.tokens = this.burstCapacity; // Start with full bucket
+        this.lastRefillTime = Date.now();
+    }
+    /**
+     * Refill tokens based on elapsed time
+     */
+    refillTokens() {
+        const now = Date.now();
+        const elapsedSeconds = (now - this.lastRefillTime) / 1000;
+        const tokensToAdd = elapsedSeconds * this.requestsPerSecond;
+        this.tokens = Math.min(this.burstCapacity, this.tokens + tokensToAdd);
+        this.lastRefillTime = now;
+    }
+    /**
+     * Calculate wait time until a token is available
+     */
+    getWaitTimeMs() {
+        if (this.tokens >= 1) {
+            return 0;
+        }
+        // Calculate time until we have at least 1 token
+        const tokensNeeded = 1 - this.tokens;
+        const secondsToWait = tokensNeeded / this.requestsPerSecond;
+        return Math.ceil(secondsToWait * 1000);
+    }
+    /**
+     * Schedule processing of the queue if not already scheduled
+     */
+    scheduleProcessing() {
+        if (this.scheduledTimeout !== null || this.pendingQueue.length === 0) {
+            return;
+        }
+        const waitTime = this.getWaitTimeMs();
+        this.scheduledTimeout = setTimeout(() => {
+            this.scheduledTimeout = null;
+            this.refillTokens();
+            this.processQueue();
+            // If there are still pending requests, schedule another processing
+            if (this.pendingQueue.length > 0) {
+                this.scheduleProcessing();
+            }
+        }, waitTime);
+    }
+    /**
+     * Process the pending queue
+     */
+    processQueue() {
+        while (this.pendingQueue.length > 0 && this.tokens >= 1) {
+            this.tokens -= 1;
+            const resolve = this.pendingQueue.shift();
+            resolve();
+        }
+    }
+    /**
+     * Acquire a token, waiting if necessary
+     * Returns a promise that resolves when a token is acquired
+     */
+    async acquire() {
+        this.refillTokens();
+        if (this.tokens >= 1) {
+            this.tokens -= 1;
+            return;
+        }
+        // Need to wait for a token
+        return new Promise((resolve) => {
+            this.pendingQueue.push(resolve);
+            this.scheduleProcessing();
+        });
+    }
+    /**
+     * Try to acquire a token without waiting
+     * Returns true if a token was acquired, false otherwise
+     */
+    tryAcquire() {
+        this.refillTokens();
+        if (this.tokens >= 1) {
+            this.tokens -= 1;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get the current number of available tokens
+     */
+    getAvailableTokens() {
+        this.refillTokens();
+        return Math.floor(this.tokens);
+    }
+    /**
+     * Get the current queue length
+     */
+    getQueueLength() {
+        return this.pendingQueue.length;
+    }
+    /**
+     * Reset the rate limiter to initial state
+     */
+    reset() {
+        this.tokens = this.burstCapacity;
+        this.lastRefillTime = Date.now();
+        // Clear any scheduled timeout
+        if (this.scheduledTimeout !== null) {
+            clearTimeout(this.scheduledTimeout);
+            this.scheduledTimeout = null;
+        }
+        // Clear pending queue
+        while (this.pendingQueue.length > 0) {
+            const resolve = this.pendingQueue.shift();
+            resolve();
+        }
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/embeddings/rate-limiter.js.map

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

package/dist/embeddings/retry.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Retry configuration options
+ */
+export interface RetryOptions {
+    maxRetries?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    maxResponseSizeBytes?: number;
+    /** Request timeout in milliseconds (default: 60000 = 60 seconds) */
+    timeoutMs?: number;
+}
+/**
+ * Set a callback function to receive retry log messages
+ */
+export declare function setRetryLogCallback(callback: ((level: 'info' | 'warn' | 'error', message: string) => void) | null): void;
+/**
+ * Execute a fetch request with exponential backoff retry
+ */
+export declare function fetchWithRetry(url: string, options: RequestInit, retryOptions?: RetryOptions): Promise<Response>;
+//# sourceMappingURL=retry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/embeddings/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgCD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,GAC7E,IAAI,CAEN;AAsJD;;GAEG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,EACpB,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,QAAQ,CAAC,CA8EnB"}

package/dist/embeddings/retry.js

@@ -0,0 +1,227 @@
+/**
+ * Default maximum response size (10MB)
+ */
+const DEFAULT_MAX_RESPONSE_SIZE = 10 * 1024 * 1024;
+/**
+ * Default request timeout (60 seconds)
+ */
+const DEFAULT_TIMEOUT_MS = 60000;
+const DEFAULT_OPTIONS = {
+    maxRetries: 5,
+    baseDelayMs: 1000,
+    maxDelayMs: 60000,
+    maxResponseSizeBytes: DEFAULT_MAX_RESPONSE_SIZE,
+    timeoutMs: DEFAULT_TIMEOUT_MS,
+};
+/**
+ * Sleep for a given number of milliseconds
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Optional callback for logging retry attempts to external systems (e.g., dashboard)
+ */
+let retryLogCallback = null;
+/**
+ * Set a callback function to receive retry log messages
+ */
+export function setRetryLogCallback(callback) {
+    retryLogCallback = callback;
+}
+/**
+ * Log a retry message to console and optional callback
+ */
+function logRetry(level, message) {
+    const prefixedMsg = `[glancey] ${message}`;
+    if (level === 'error') {
+        console.error(prefixedMsg);
+    }
+    else if (level === 'warn') {
+        console.warn(prefixedMsg);
+    }
+    else {
+        console.error(prefixedMsg); // Use stderr for all server logs
+    }
+    if (retryLogCallback) {
+        retryLogCallback(level, message);
+    }
+}
+/**
+ * Check if response size exceeds the maximum allowed
+ */
+function checkResponseSize(response, maxSize) {
+    const contentLength = response.headers?.get?.('content-length');
+    if (contentLength) {
+        const size = parseInt(contentLength, 10);
+        if (!isNaN(size) && size > maxSize) {
+            throw new Error(`Response size ${size} bytes exceeds maximum allowed ${maxSize} bytes`);
+        }
+    }
+}
+/**
+ * Check if an error is retryable (network errors, rate limits, server errors, timeouts)
+ */
+function isRetryableError(error) {
+    if (error instanceof Error) {
+        const message = error.message.toLowerCase();
+        // Retry on network errors and timeouts
+        if (message.includes('fetch') ||
+            message.includes('network') ||
+            message.includes('econnrefused') ||
+            message.includes('timeout') ||
+            message.includes('aborted')) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Check if a response status is retryable
+ */
+function isRetryableStatus(status) {
+    // Retry on rate limits (429), server errors (5xx), and some specific cases
+    return status === 429 || status === 408 || (status >= 500 && status < 600);
+}
+/**
+ * Check if a 429 error is a quota exhaustion (not retryable) vs temporary rate limit (retryable)
+ * Quota exhaustion means daily/monthly limits exceeded - retrying won't help
+ */
+async function isQuotaExhausted(response) {
+    if (response.status !== 429) {
+        return { exhausted: false, message: '' };
+    }
+    try {
+        const text = await response.text();
+        const lowerText = text.toLowerCase();
+        // Check for quota exhaustion indicators in the response
+        const quotaIndicators = [
+            'exceeded your current quota',
+            'resource_exhausted',
+            'quota exceeded',
+            'quotafailure',
+            'daily limit',
+            'monthly limit',
+            'billing',
+        ];
+        for (const indicator of quotaIndicators) {
+            if (lowerText.includes(indicator)) {
+                return { exhausted: true, message: text };
+            }
+        }
+        return { exhausted: false, message: text };
+    }
+    catch {
+        // If we can't read the body, assume it's a temporary rate limit
+        return { exhausted: false, message: '' };
+    }
+}
+/**
+ * Parse Retry-After header value
+ * Returns delay in milliseconds, or null if not present/parseable
+ */
+function parseRetryAfter(response) {
+    const retryAfter = response.headers?.get?.('retry-after');
+    if (!retryAfter) {
+        return null;
+    }
+    // Try parsing as number of seconds
+    const seconds = parseInt(retryAfter, 10);
+    if (!isNaN(seconds) && seconds > 0) {
+        return seconds * 1000;
+    }
+    // Try parsing as HTTP date
+    const date = Date.parse(retryAfter);
+    if (!isNaN(date)) {
+        const delayMs = date - Date.now();
+        return delayMs > 0 ? delayMs : null;
+    }
+    return null;
+}
+/**
+ * Calculate retry delay, respecting Retry-After header for 429 errors
+ */
+function calculateRetryDelay(response, attempt, opts) {
+    // For 429 errors, check Retry-After header first
+    if (response.status === 429) {
+        const retryAfter = parseRetryAfter(response);
+        if (retryAfter !== null) {
+            // Use Retry-After value, but cap at maxDelayMs and add small jitter
+            const jitter = Math.random() * 1000;
+            return Math.min(retryAfter + jitter, opts.maxDelayMs);
+        }
+        // No Retry-After header - use longer base delay for rate limits
+        const rateLimitBaseDelay = Math.max(opts.baseDelayMs * 2, 2000);
+        return Math.min(rateLimitBaseDelay * Math.pow(2, attempt), opts.maxDelayMs);
+    }
+    // Standard exponential backoff for other errors
+    return Math.min(opts.baseDelayMs * Math.pow(2, attempt), opts.maxDelayMs);
+}
+/**
+ * Execute a fetch request with exponential backoff retry
+ */
+export async function fetchWithRetry(url, options, retryOptions) {
+    const opts = { ...DEFAULT_OPTIONS, ...retryOptions };
+    let lastError = null;
+    for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
+        // Create AbortController for timeout
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), opts.timeoutMs);
+        try {
+            const response = await fetch(url, {
+                ...options,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            // Check response size before processing
+            checkResponseSize(response, opts.maxResponseSizeBytes);
+            // If response is ok or non-retryable error, return it
+            if (response.ok || !isRetryableStatus(response.status)) {
+                return response;
+            }
+            // For 429 errors, check if it's quota exhaustion (not retryable)
+            if (response.status === 429) {
+                const { exhausted, message } = await isQuotaExhausted(response);
+                if (exhausted) {
+                    logRetry('error', 'API quota exhausted (daily/monthly limit reached). Skipping retries.');
+                    // Create a new Response with the same status but the body we already read
+                    const errorResponse = new Response(message, {
+                        status: response.status,
+                        statusText: response.statusText,
+                        headers: response.headers,
+                    });
+                    return errorResponse;
+                }
+            }
+            // Retryable status code
+            if (attempt < opts.maxRetries) {
+                const delay = calculateRetryDelay(response, attempt, opts);
+                const retryAfterInfo = response.status === 429 ? ' (rate limited)' : '';
+                logRetry('warn', `Request failed with status ${response.status}${retryAfterInfo}, retrying in ${Math.round(delay / 1000)}s (attempt ${attempt + 1}/${opts.maxRetries})`);
+                await sleep(delay);
+                continue;
+            }
+            // Last attempt, return the response even if it's an error
+            return response;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            // Convert abort errors to timeout errors for clarity
+            if (error instanceof Error && error.name === 'AbortError') {
+                lastError = new Error(`Request timeout after ${opts.timeoutMs}ms`);
+            }
+            else {
+                lastError = error instanceof Error ? error : new Error(String(error));
+            }
+            if (attempt < opts.maxRetries && isRetryableError(error)) {
+                const delay = Math.min(opts.baseDelayMs * Math.pow(2, attempt), opts.maxDelayMs);
+                logRetry('warn', `Request failed: ${lastError.message}, retrying in ${delay}ms (attempt ${attempt + 1}/${opts.maxRetries})`);
+                await sleep(delay);
+                continue;
+            }
+            throw lastError;
+        }
+    }
+    throw lastError || new Error('Request failed after retries');
+}
+//# sourceMappingURL=retry.js.map

package/dist/embeddings/retry.js.map

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

package/dist/embeddings/types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Embedding backend interface that all embedding providers must implement.
+ * Supports both single text and batch embedding operations.
+ */
+export interface EmbeddingBackend {
+    /** Display name of the embedding backend (e.g., 'gemini', 'ollama') */
+    name: string;
+    /**
+     * Initialize the backend, validating credentials and connectivity.
+     * @throws Error if initialization fails (e.g., invalid API key, server unreachable)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Generate an embedding vector for a single text.
+     * @param text - The text to embed
+     * @returns A promise resolving to the embedding vector (array of numbers)
+     */
+    embed(text: string): Promise<number[]>;
+    /**
+     * Generate embedding vectors for multiple texts in a single batch.
+     * More efficient than calling embed() multiple times.
+     * @param texts - Array of texts to embed
+     * @returns A promise resolving to an array of embedding vectors
+     */
+    embedBatch(texts: string[]): Promise<number[][]>;
+    /**
+     * Get the dimensionality of the embedding vectors produced by this backend.
+     * @returns The number of dimensions in the embedding vectors
+     */
+    getDimensions(): number;
+    /**
+     * Get the model identifier used by this backend.
+     * @returns The model name/identifier (e.g., 'nomic-embed-text', 'gemini-embedding-001')
+     */
+    getModel(): string;
+}
+/**
+ * Configuration options for embedding backends.
+ */
+export interface EmbeddingConfig {
+    /** Which embedding backend to use */
+    backend: 'ollama' | 'gemini' | 'local';
+    /** Model name/identifier (backend-specific) */
+    model?: string;
+    /** API key for cloud-based backends (Gemini) */
+    apiKey?: string;
+    /** Base URL for the embedding API (useful for Ollama or custom endpoints) */
+    baseUrl?: string;
+    /** Rate limiting: maximum requests per second */
+    rateLimitRps?: number;
+    /** Rate limiting: maximum burst capacity (default: 10) */
+    rateLimitBurst?: number;
+    /**
+     * Maximum number of texts to process in a single batch request.
+     * Large batches are automatically split into smaller chunks to prevent
+     * timeouts, memory issues, and API rate limit errors.
+     * Default: 100 for Ollama
+     */
+    batchSize?: number;
+    /**
+     * Maximum number of concurrent batch requests (Ollama only).
+     * Controls how many batch requests are sent in parallel.
+     * Default: 4 for Ollama
+     */
+    concurrency?: number;
+}
+/**
+ * Split an array into chunks of specified size.
+ * @param array - The array to chunk
+ * @param size - Maximum size of each chunk
+ * @returns Array of chunks
+ */
+export declare function chunkArray<T>(array: T[], size: number): T[][];
+/**
+ * Default embedding configuration using Google Gemini.
+ * Gemini offers a free tier with 1500 RPM.
+ * Get API key at: https://aistudio.google.com/app/apikey
+ */
+export declare const DEFAULT_CONFIG: EmbeddingConfig;
+/**
+ * Information about a backend fallback that occurred during initialization.
+ * This is returned when the configured backend fails and we fall back to another.
+ */
+export interface BackendFallbackInfo {
+    /** Whether a fallback occurred */
+    occurred: true;
+    /** The backend that was originally configured */
+    originalBackend: string;
+    /** The backend we fell back to */
+    fallbackBackend: string;
+    /** The error message from the original backend failure */
+    reason: string;
+}
+/**
+ * Result of creating an embedding backend, including optional fallback info.
+ */
+export interface CreateBackendResult {
+    /** The initialized embedding backend */
+    backend: EmbeddingBackend;
+    /** Information about fallback if one occurred */
+    fallback?: BackendFallbackInfo;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEvC;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEjD;;;OAGG;IACH,aAAa,IAAI,MAAM,CAAC;IAExB;;;OAGG;IACH,QAAQ,IAAI,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IAEvC,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAM7D;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,eAG5B,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,QAAQ,EAAE,IAAI,CAAC;IACf,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAChC"}

package/dist/embeddings/types.js

@@ -0,0 +1,23 @@
+/**
+ * Split an array into chunks of specified size.
+ * @param array - The array to chunk
+ * @param size - Maximum size of each chunk
+ * @returns Array of chunks
+ */
+export function chunkArray(array, size) {
+    const chunks = [];
+    for (let i = 0; i < array.length; i += size) {
+        chunks.push(array.slice(i, i + size));
+    }
+    return chunks;
+}
+/**
+ * Default embedding configuration using Google Gemini.
+ * Gemini offers a free tier with 1500 RPM.
+ * Get API key at: https://aistudio.google.com/app/apikey
+ */
+export const DEFAULT_CONFIG = {
+    backend: 'gemini',
+    model: 'gemini-embedding-001',
+};
+//# sourceMappingURL=types.js.map

package/dist/embeddings/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":"AAgFA;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAI,KAAU,EAAE,IAAY;IACpD,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,OAAO,EAAE,QAAQ;IACjB,KAAK,EAAE,sBAAsB;CAC9B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Invalidate config and indexer caches to force reload on next access.
+ * Call this when config files change.
+ */
+export declare function invalidateCaches(): void;
+/**
+ * Reload config and reinitialize the indexer.
+ * Returns true if reload was successful, false otherwise.
+ */
+export declare function reloadConfig(): Promise<boolean>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AA8ZA;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC;AAED;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CA0CrD"}