osagent-core 0.1.39 → 0.1.87

package/dist/src/services/embeddings/ollamaEmbedding.js

@@ -0,0 +1,203 @@
+/**
+ * @license
+ * Copyright 2025 OSAgent OC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { EmbeddingError } from './types.js';
+/**
+ * Ollama Embedding Provider
+ *
+ * Primary embedding provider using local Ollama instance.
+ * Uses nomic-embed-text model (768 dimensions) by default.
+ *
+ * @see https://ollama.com/blog/embedding-models
+ */
+export class OllamaEmbeddingProvider {
+    name = 'ollama';
+    baseUrl;
+    model;
+    timeoutMs;
+    dimensions;
+    constructor(config = {}) {
+        // Check OLLAMA_HOST env var for WSL/remote setups
+        const ollamaHost = process.env['OLLAMA_HOST'];
+        const ollamaBaseUrl = process.env['OLLAMA_BASE_URL'];
+        const effectiveUrl = ollamaHost
+            ? (ollamaHost.startsWith('http') ? ollamaHost : `http://${ollamaHost}`)
+            : (ollamaBaseUrl?.replace(/\/v1\/?$/, '') ?? 'http://localhost:11434');
+        this.baseUrl = config.baseUrl ?? effectiveUrl.replace(/\/$/, '');
+        this.model = config.model ?? 'nomic-embed-text';
+        this.timeoutMs = config.timeoutMs ?? 30000;
+        // nomic-embed-text produces 768-dimensional embeddings
+        this.dimensions = this.model.includes('nomic') ? 768 : 384;
+    }
+    getDimensions() {
+        return this.dimensions;
+    }
+    /**
+     * Check if Ollama is running and the model is available
+     */
+    async isAvailable() {
+        try {
+            // Check if Ollama server is running
+            const response = await fetch(`${this.baseUrl}/api/tags`, {
+                method: 'GET',
+                signal: AbortSignal.timeout(5000),
+            });
+            if (!response.ok) {
+                return false;
+            }
+            // Check if the embedding model is available
+            const data = (await response.json());
+            const models = data.models ?? [];
+            const modelAvailable = models.some((m) => m.name === this.model || m.name.startsWith(`${this.model}:`));
+            if (!modelAvailable) {
+                console.warn(`[OllamaEmbedding] Model ${this.model} not found. Available: ${models.map((m) => m.name).join(', ')}`);
+                console.warn(`[OllamaEmbedding] Pull it with: ollama pull ${this.model}`);
+            }
+            return modelAvailable;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Generate embedding for a single text
+     */
+    async embed(text) {
+        if (!text || text.trim().length === 0) {
+            throw new EmbeddingError('Text cannot be empty', 'invalid_input', this.name);
+        }
+        try {
+            const response = await fetch(`${this.baseUrl}/api/embed`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    model: this.model,
+                    input: text,
+                }),
+                signal: AbortSignal.timeout(this.timeoutMs),
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                if (response.status === 404) {
+                    throw new EmbeddingError(`Model ${this.model} not found. Run: ollama pull ${this.model}`, 'model_not_found', this.name);
+                }
+                throw new EmbeddingError(`Ollama API error: ${response.status} - ${errorText}`, 'unknown', this.name);
+            }
+            const data = (await response.json());
+            if (!data.embeddings || data.embeddings.length === 0) {
+                throw new EmbeddingError('No embeddings returned from Ollama', 'unknown', this.name);
+            }
+            return data.embeddings[0];
+        }
+        catch (error) {
+            if (error instanceof EmbeddingError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                if (error.name === 'TimeoutError' || error.name === 'AbortError') {
+                    throw new EmbeddingError(`Ollama request timed out after ${this.timeoutMs}ms`, 'timeout', this.name, error);
+                }
+                if (error.message.includes('ECONNREFUSED') || error.message.includes('fetch failed')) {
+                    throw new EmbeddingError('Ollama server not running. Start with: ollama serve', 'provider_unavailable', this.name, error);
+                }
+            }
+            throw new EmbeddingError(`Ollama embedding failed: ${error instanceof Error ? error.message : String(error)}`, 'unknown', this.name, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Generate embeddings for multiple texts (batch operation)
+     */
+    async embedBatch(texts) {
+        if (texts.length === 0) {
+            return [];
+        }
+        // Filter out empty texts
+        const validTexts = texts.filter((t) => t && t.trim().length > 0);
+        if (validTexts.length === 0) {
+            throw new EmbeddingError('All texts are empty', 'invalid_input', this.name);
+        }
+        try {
+            const response = await fetch(`${this.baseUrl}/api/embed`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    model: this.model,
+                    input: validTexts,
+                }),
+                signal: AbortSignal.timeout(this.timeoutMs * 2), // Longer timeout for batch
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new EmbeddingError(`Ollama batch API error: ${response.status} - ${errorText}`, 'unknown', this.name);
+            }
+            const data = (await response.json());
+            if (!data.embeddings) {
+                throw new EmbeddingError('No embeddings returned from Ollama batch', 'unknown', this.name);
+            }
+            return data.embeddings;
+        }
+        catch (error) {
+            if (error instanceof EmbeddingError) {
+                throw error;
+            }
+            // Fallback to sequential embedding if batch fails
+            console.warn('[OllamaEmbedding] Batch failed, falling back to sequential');
+            const results = [];
+            for (const text of validTexts) {
+                results.push(await this.embed(text));
+            }
+            return results;
+        }
+    }
+    /**
+     * Pull the embedding model if not available
+     */
+    async pullModel() {
+        try {
+            console.log(`[OllamaEmbedding] Pulling model ${this.model}...`);
+            const response = await fetch(`${this.baseUrl}/api/pull`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ name: this.model }),
+                signal: AbortSignal.timeout(600000), // 10 minute timeout for model download
+            });
+            if (!response.ok) {
+                console.error(`[OllamaEmbedding] Failed to pull model: ${response.status}`);
+                return false;
+            }
+            // Stream the response to show progress
+            const reader = response.body?.getReader();
+            if (reader) {
+                const decoder = new TextDecoder();
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    const chunk = decoder.decode(value);
+                    // Parse NDJSON response
+                    const lines = chunk.split('\n').filter((l) => l.trim());
+                    for (const line of lines) {
+                        try {
+                            const data = JSON.parse(line);
+                            if (data.status) {
+                                console.log(`[OllamaEmbedding] ${data.status}`);
+                            }
+                        }
+                        catch {
+                            // Ignore parse errors
+                        }
+                    }
+                }
+            }
+            console.log(`[OllamaEmbedding] Model ${this.model} pulled successfully`);
+            return true;
+        }
+        catch (error) {
+            console.error(`[OllamaEmbedding] Failed to pull model: ${error}`);
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=ollamaEmbedding.js.map

package/dist/src/services/embeddings/ollamaEmbedding.js.map

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

package/dist/src/services/embeddings/openRouterEmbedding.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright 2025 OSAgent OC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { EmbeddingProvider, OpenRouterEmbeddingConfig } from './types.js';
+/**
+ * OpenRouter Embedding Provider
+ *
+ * Fallback embedding provider using OpenRouter API.
+ * Uses text-embedding-3-small model (1536 dimensions) by default.
+ *
+ * @see https://openrouter.ai/docs/api/reference/embeddings
+ */
+export declare class OpenRouterEmbeddingProvider implements EmbeddingProvider {
+    readonly name = "openrouter";
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly model;
+    private readonly timeoutMs;
+    private readonly dimensions;
+    constructor(config: OpenRouterEmbeddingConfig);
+    getDimensions(): number;
+    /**
+     * Check if OpenRouter is available with valid API key
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Generate embedding for a single text
+     */
+    embed(text: string): Promise<number[]>;
+    /**
+     * Generate embeddings for multiple texts (batch operation)
+     */
+    embedBatch(texts: string[]): Promise<number[][]>;
+    /**
+     * Check remaining credits (if supported)
+     */
+    getCredits(): Promise<{
+        remaining: number;
+        limit: number;
+    } | null>;
+}

package/dist/src/services/embeddings/openRouterEmbedding.js

@@ -0,0 +1,212 @@
+/**
+ * @license
+ * Copyright 2025 OSAgent OC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { EmbeddingError } from './types.js';
+/**
+ * OpenRouter Embedding Provider
+ *
+ * Fallback embedding provider using OpenRouter API.
+ * Uses text-embedding-3-small model (1536 dimensions) by default.
+ *
+ * @see https://openrouter.ai/docs/api/reference/embeddings
+ */
+export class OpenRouterEmbeddingProvider {
+    name = 'openrouter';
+    apiKey;
+    baseUrl;
+    model;
+    timeoutMs;
+    dimensions;
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new Error('OpenRouter API key is required');
+        }
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl ?? 'https://openrouter.ai/api/v1';
+        this.model = config.model ?? 'openai/text-embedding-3-small';
+        this.timeoutMs = config.timeoutMs ?? 30000;
+        // Dimensions based on model
+        if (this.model.includes('text-embedding-3-large')) {
+            this.dimensions = 3072;
+        }
+        else if (this.model.includes('text-embedding-3-small')) {
+            this.dimensions = 1536;
+        }
+        else if (this.model.includes('text-embedding-ada')) {
+            this.dimensions = 1536;
+        }
+        else {
+            this.dimensions = 1536; // Default fallback
+        }
+    }
+    getDimensions() {
+        return this.dimensions;
+    }
+    /**
+     * Check if OpenRouter is available with valid API key
+     */
+    async isAvailable() {
+        try {
+            // Make a minimal request to verify the API key
+            const response = await fetch(`${this.baseUrl}/models`, {
+                method: 'GET',
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    'HTTP-Referer': 'https://osagent.dev',
+                    'X-Title': 'OSAgent',
+                },
+                signal: AbortSignal.timeout(5000),
+            });
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Generate embedding for a single text
+     */
+    async embed(text) {
+        if (!text || text.trim().length === 0) {
+            throw new EmbeddingError('Text cannot be empty', 'invalid_input', this.name);
+        }
+        try {
+            const response = await fetch(`${this.baseUrl}/embeddings`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.apiKey}`,
+                    'HTTP-Referer': 'https://osagent.dev',
+                    'X-Title': 'OSAgent',
+                },
+                body: JSON.stringify({
+                    model: this.model,
+                    input: text,
+                }),
+                signal: AbortSignal.timeout(this.timeoutMs),
+            });
+            if (!response.ok) {
+                const errorData = (await response.json().catch(() => ({})));
+                const errorMessage = errorData.error?.message || `HTTP ${response.status}`;
+                if (response.status === 401) {
+                    throw new EmbeddingError('Invalid OpenRouter API key', 'provider_unavailable', this.name);
+                }
+                if (response.status === 402) {
+                    throw new EmbeddingError('OpenRouter credits exhausted. Add credits at openrouter.ai', 'rate_limit', this.name);
+                }
+                if (response.status === 429) {
+                    throw new EmbeddingError('OpenRouter rate limit exceeded', 'rate_limit', this.name);
+                }
+                throw new EmbeddingError(`OpenRouter API error: ${errorMessage}`, 'unknown', this.name);
+            }
+            const data = (await response.json());
+            if (!data.data || data.data.length === 0 || !data.data[0].embedding) {
+                throw new EmbeddingError('No embeddings returned from OpenRouter', 'unknown', this.name);
+            }
+            return data.data[0].embedding;
+        }
+        catch (error) {
+            if (error instanceof EmbeddingError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                if (error.name === 'TimeoutError' || error.name === 'AbortError') {
+                    throw new EmbeddingError(`OpenRouter request timed out after ${this.timeoutMs}ms`, 'timeout', this.name, error);
+                }
+                if (error.message.includes('fetch failed') || error.message.includes('ENOTFOUND')) {
+                    throw new EmbeddingError('Cannot reach OpenRouter API. Check your internet connection.', 'network_error', this.name, error);
+                }
+            }
+            throw new EmbeddingError(`OpenRouter embedding failed: ${error instanceof Error ? error.message : String(error)}`, 'unknown', this.name, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Generate embeddings for multiple texts (batch operation)
+     */
+    async embedBatch(texts) {
+        if (texts.length === 0) {
+            return [];
+        }
+        // Filter out empty texts
+        const validTexts = texts.filter((t) => t && t.trim().length > 0);
+        if (validTexts.length === 0) {
+            throw new EmbeddingError('All texts are empty', 'invalid_input', this.name);
+        }
+        try {
+            const response = await fetch(`${this.baseUrl}/embeddings`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.apiKey}`,
+                    'HTTP-Referer': 'https://osagent.dev',
+                    'X-Title': 'OSAgent',
+                },
+                body: JSON.stringify({
+                    model: this.model,
+                    input: validTexts,
+                }),
+                signal: AbortSignal.timeout(this.timeoutMs * 2), // Longer timeout for batch
+            });
+            if (!response.ok) {
+                const errorData = (await response.json().catch(() => ({})));
+                const errorMessage = errorData.error?.message || `HTTP ${response.status}`;
+                throw new EmbeddingError(`OpenRouter batch API error: ${errorMessage}`, 'unknown', this.name);
+            }
+            const data = (await response.json());
+            if (!data.data) {
+                throw new EmbeddingError('No embeddings returned from OpenRouter batch', 'unknown', this.name);
+            }
+            // Sort by index to ensure correct order
+            const sorted = data.data.sort((a, b) => (a.index ?? 0) - (b.index ?? 0));
+            return sorted.map((item) => {
+                if (!item.embedding) {
+                    throw new EmbeddingError('Missing embedding in OpenRouter batch response', 'unknown', this.name);
+                }
+                return item.embedding;
+            });
+        }
+        catch (error) {
+            if (error instanceof EmbeddingError) {
+                throw error;
+            }
+            // Fallback to sequential embedding if batch fails
+            console.warn('[OpenRouterEmbedding] Batch failed, falling back to sequential');
+            const results = [];
+            for (const text of validTexts) {
+                results.push(await this.embed(text));
+            }
+            return results;
+        }
+    }
+    /**
+     * Check remaining credits (if supported)
+     */
+    async getCredits() {
+        try {
+            const response = await fetch(`${this.baseUrl}/auth/key`, {
+                method: 'GET',
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                },
+                signal: AbortSignal.timeout(5000),
+            });
+            if (!response.ok) {
+                return null;
+            }
+            const data = (await response.json());
+            if (data.data) {
+                return {
+                    remaining: (data.data.limit ?? 0) - (data.data.usage ?? 0),
+                    limit: data.data.limit ?? 0,
+                };
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=openRouterEmbedding.js.map

package/dist/src/services/embeddings/openRouterEmbedding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openRouterEmbedding.js","sourceRoot":"","sources":["../../../../src/services/embeddings/openRouterEmbedding.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,OAAO,2BAA2B;IAC7B,IAAI,GAAG,YAAY,CAAC;IAEZ,MAAM,CAAS;IACf,OAAO,CAAS;IAChB,KAAK,CAAS;IACd,SAAS,CAAS;IAClB,UAAU,CAAS;IAEpC,YAAY,MAAiC;QAC3C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,8BAA8B,CAAC;QAChE,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,+BAA+B,CAAC;QAC7D,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,KAAK,CAAC;QAE3C,4BAA4B;QAC5B,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,mBAAmB;QAC7C,CAAC;IACH,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,IAAI,CAAC;YACH,+CAA+C;YAC/C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,SAAS,EAAE;gBACrD,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;oBACtC,cAAc,EAAE,qBAAqB;oBACrC,SAAS,EAAE,SAAS;iBACrB;gBACD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;aAClC,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,cAAc,CAAC,sBAAsB,EAAE,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/E,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,aAAa,EAAE;gBACzD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;oBACtC,cAAc,EAAE,qBAAqB;oBACrC,SAAS,EAAE,SAAS;iBACrB;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,KAAK,EAAE,IAAI;iBACZ,CAAC;gBACF,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;aAC5C,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAEzD,CAAC;gBACF,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,IAAI,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAE3E,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBAC5B,MAAM,IAAI,cAAc,CACtB,4BAA4B,EAC5B,sBAAsB,EACtB,IAAI,CAAC,IAAI,CACV,CAAC;gBACJ,CAAC;gBAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBAC5B,MAAM,IAAI,cAAc,CACtB,4DAA4D,EAC5D,YAAY,EACZ,IAAI,CAAC,IAAI,CACV,CAAC;gBACJ,CAAC;gBAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBAC5B,MAAM,IAAI,cAAc,CAAC,gCAAgC,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBACtF,CAAC;gBAED,MAAM,IAAI,cAAc,CAAC,yBAAyB,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1F,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAElC,CAAC;YAEF,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;gBACpE,MAAM,IAAI,cAAc,CAAC,wCAAwC,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3F,CAAC;YAED,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;gBACpC,MAAM,KAAK,CAAC;YACd,CAAC;YAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBACjE,MAAM,IAAI,cAAc,CACtB,sCAAsC,IAAI,CAAC,SAAS,IAAI,EACxD,SAAS,EACT,IAAI,CAAC,IAAI,EACT,KAAK,CACN,CAAC;gBACJ,CAAC;gBAED,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;oBAClF,MAAM,IAAI,cAAc,CACtB,8DAA8D,EAC9D,eAAe,EACf,IAAI,CAAC,IAAI,EACT,KAAK,CACN,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,MAAM,IAAI,cAAc,CACtB,gCAAgC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACxF,SAAS,EACT,IAAI,CAAC,IAAI,EACT,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC3C,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,yBAAyB;QACzB,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEjE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,cAAc,CAAC,qBAAqB,EAAE,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9E,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,aAAa,EAAE;gBACzD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;oBACtC,cAAc,EAAE,qBAAqB;oBACrC,SAAS,EAAE,SAAS;iBACrB;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,KAAK,EAAE,UAAU;iBAClB,CAAC;gBACF,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,2BAA2B;aAC7E,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAEzD,CAAC;gBACF,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,IAAI,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAC3E,MAAM,IAAI,cAAc,CACtB,+BAA+B,YAAY,EAAE,EAC7C,SAAS,EACT,IAAI,CAAC,IAAI,CACV,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAElC,CAAC;YAEF,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACf,MAAM,IAAI,cAAc,CACtB,8CAA8C,EAC9C,SAAS,EACT,IAAI,CAAC,IAAI,CACV,CAAC;YACJ,CAAC;YAED,wCAAwC;YACxC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;YAEzE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACzB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;oBACpB,MAAM,IAAI,cAAc,CACtB,gDAAgD,EAChD,SAAS,EACT,IAAI,CAAC,IAAI,CACV,CAAC;gBACJ,CAAC;gBACD,OAAO,IAAI,CAAC,SAAS,CAAC;YACxB,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;gBACpC,MAAM,KAAK,CAAC;YACd,CAAC;YAED,kDAAkD;YAClD,OAAO,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;YAC/E,MAAM,OAAO,GAAe,EAAE,CAAC;YAC/B,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;gBAC9B,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YACvC,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,WAAW,EAAE;gBACvD,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;iBACvC;gBACD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;aAClC,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAElC,CAAC;YAEF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO;oBACL,SAAS,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;oBAC1D,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;iBAC5B,CAAC;YACJ,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/src/services/embeddings/types.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @license
+ * Copyright 2025 OSAgent OC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Embedding Provider Interface
+ *
+ * Defines the contract for embedding providers (Ollama, OpenRouter, etc.)
+ * that convert text into vector representations for semantic search.
+ */
+export interface EmbeddingProvider {
+    /** Provider name for logging/debugging */
+    readonly name: string;
+    /** Get embedding dimensions (e.g., 768 for nomic-embed-text, 1536 for OpenAI) */
+    getDimensions(): number;
+    /** Check if provider is available and configured */
+    isAvailable(): Promise<boolean>;
+    /** Generate embedding for a single text */
+    embed(text: string): Promise<number[]>;
+    /** Generate embeddings for multiple texts (batch operation) */
+    embedBatch(texts: string[]): Promise<number[][]>;
+}
+/**
+ * Embedding result with metadata
+ */
+export interface EmbeddingResult {
+    /** The embedding vector */
+    embedding: number[];
+    /** Provider that generated this embedding */
+    provider: string;
+    /** Model used for embedding */
+    model: string;
+    /** Time taken in milliseconds */
+    durationMs: number;
+    /** Token count if available */
+    tokenCount?: number;
+}
+/**
+ * Embedding service configuration
+ */
+export interface EmbeddingServiceConfig {
+    /** Primary provider (tried first) */
+    primaryProvider?: EmbeddingProvider;
+    /** Fallback provider (used if primary fails) */
+    fallbackProvider?: EmbeddingProvider;
+    /** Whether to cache embeddings */
+    enableCache?: boolean;
+    /** Cache TTL in milliseconds */
+    cacheTtlMs?: number;
+    /** Maximum batch size for batch operations */
+    maxBatchSize?: number;
+}
+/**
+ * Ollama embedding configuration
+ */
+export interface OllamaEmbeddingConfig {
+    /** Ollama API base URL (default: http://localhost:11434) */
+    baseUrl?: string;
+    /** Model to use (default: nomic-embed-text) */
+    model?: string;
+    /** Request timeout in milliseconds */
+    timeoutMs?: number;
+}
+/**
+ * OpenRouter embedding configuration
+ */
+export interface OpenRouterEmbeddingConfig {
+    /** OpenRouter API key */
+    apiKey: string;
+    /** API base URL (default: https://openrouter.ai/api/v1) */
+    baseUrl?: string;
+    /** Model to use (default: text-embedding-3-small) */
+    model?: string;
+    /** Request timeout in milliseconds */
+    timeoutMs?: number;
+}
+/**
+ * Embedding error types
+ */
+export type EmbeddingErrorType = 'provider_unavailable' | 'model_not_found' | 'rate_limit' | 'timeout' | 'invalid_input' | 'network_error' | 'unknown';
+/**
+ * Custom error for embedding operations
+ */
+export declare class EmbeddingError extends Error {
+    readonly type: EmbeddingErrorType;
+    readonly provider: string;
+    readonly cause?: Error;
+    constructor(message: string, type: EmbeddingErrorType, provider: string, cause?: Error);
+}

package/dist/src/services/embeddings/types.js

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2025 OSAgent OC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Custom error for embedding operations
+ */
+export class EmbeddingError extends Error {
+    type;
+    provider;
+    cause;
+    constructor(message, type, provider, cause) {
+        super(message);
+        this.name = 'EmbeddingError';
+        this.type = type;
+        this.provider = provider;
+        this.cause = cause;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/src/services/embeddings/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/services/embeddings/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4GH;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvB,IAAI,CAAqB;IACzB,QAAQ,CAAS;IACR,KAAK,CAAS;IAEvC,YACE,OAAe,EACf,IAAwB,EACxB,QAAgB,EAChB,KAAa;QAEb,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}