@opensaas/stack-rag 0.1.6

package/dist/fields/embedding.test.js

@@ -0,0 +1,323 @@
+import { describe, it, expect } from 'vitest';
+import { embedding } from './embedding.js';
+import { z } from 'zod';
+describe('Embedding Field', () => {
+    describe('embedding field builder', () => {
+        it('should create embedding field with default options', () => {
+            const field = embedding();
+            expect(field.type).toBe('embedding');
+            expect(field.dimensions).toBe(1536); // Default OpenAI dimensions
+            expect(field.autoGenerate).toBe(false); // No sourceField
+        });
+        it('should create embedding field with custom dimensions', () => {
+            const field = embedding({ dimensions: 3072 });
+            expect(field.dimensions).toBe(3072);
+        });
+        it('should set autoGenerate to true when sourceField is provided', () => {
+            const field = embedding({ sourceField: 'content' });
+            expect(field.autoGenerate).toBe(true);
+            expect(field.sourceField).toBe('content');
+        });
+        it('should allow explicit autoGenerate override', () => {
+            const field = embedding({ sourceField: 'content', autoGenerate: false });
+            expect(field.autoGenerate).toBe(false);
+            expect(field.sourceField).toBe('content');
+        });
+        it('should support provider configuration', () => {
+            const field = embedding({ provider: 'openai' });
+            expect(field.provider).toBe('openai');
+        });
+        it('should support chunking configuration', () => {
+            const field = embedding({
+                sourceField: 'content',
+                chunking: {
+                    strategy: 'recursive',
+                    maxTokens: 500,
+                    overlap: 50,
+                },
+            });
+            expect(field.chunking).toEqual({
+                strategy: 'recursive',
+                maxTokens: 500,
+                overlap: 50,
+            });
+        });
+        it('should support UI configuration', () => {
+            const field = embedding({
+                ui: {
+                    showVector: true,
+                    showMetadata: true,
+                },
+            });
+            expect(field.ui).toEqual({
+                showVector: true,
+                showMetadata: true,
+            });
+        });
+    });
+    describe('getZodSchema', () => {
+        it('should generate valid Zod schema', () => {
+            const field = embedding({ dimensions: 3 });
+            const schema = field.getZodSchema('embedding', 'create');
+            expect(schema).toBeDefined();
+            expect(schema instanceof z.ZodType).toBe(true);
+        });
+        it('should validate correct embedding structure', () => {
+            const field = embedding({ dimensions: 3 });
+            const schema = field.getZodSchema('embedding', 'create');
+            const validEmbedding = {
+                vector: [0.1, 0.2, 0.3],
+                metadata: {
+                    model: 'text-embedding-3-small',
+                    provider: 'openai',
+                    dimensions: 3,
+                    generatedAt: new Date().toISOString(),
+                },
+            };
+            expect(() => schema.parse(validEmbedding)).not.toThrow();
+        });
+        it('should accept null embedding', () => {
+            const field = embedding({ dimensions: 3 });
+            const schema = field.getZodSchema('embedding', 'create');
+            expect(() => schema.parse(null)).not.toThrow();
+        });
+        it('should accept undefined embedding', () => {
+            const field = embedding({ dimensions: 3 });
+            const schema = field.getZodSchema('embedding', 'create');
+            expect(() => schema.parse(undefined)).not.toThrow();
+        });
+        it('should reject incorrect vector dimensions', () => {
+            const field = embedding({ dimensions: 3 });
+            const schema = field.getZodSchema('embedding', 'create');
+            const invalidEmbedding = {
+                vector: [0.1, 0.2], // Only 2 dimensions, expected 3
+                metadata: {
+                    model: 'test',
+                    provider: 'test',
+                    dimensions: 2,
+                    generatedAt: new Date().toISOString(),
+                },
+            };
+            expect(() => schema.parse(invalidEmbedding)).toThrow(/exactly 3 dimensions/);
+        });
+        it('should validate metadata structure', () => {
+            const field = embedding({ dimensions: 3 });
+            const schema = field.getZodSchema('embedding', 'create');
+            const invalidEmbedding = {
+                vector: [0.1, 0.2, 0.3],
+                metadata: {
+                    // Missing required fields
+                    model: 'test',
+                },
+            };
+            expect(() => schema.parse(invalidEmbedding)).toThrow();
+        });
+        it('should accept optional sourceHash in metadata', () => {
+            const field = embedding({ dimensions: 3 });
+            const schema = field.getZodSchema('embedding', 'create');
+            const embeddingWithHash = {
+                vector: [0.1, 0.2, 0.3],
+                metadata: {
+                    model: 'test',
+                    provider: 'test',
+                    dimensions: 3,
+                    generatedAt: new Date().toISOString(),
+                    sourceHash: 'abc123',
+                },
+            };
+            expect(() => schema.parse(embeddingWithHash)).not.toThrow();
+        });
+        it('should work for both create and update operations', () => {
+            const field = embedding({ dimensions: 3 });
+            const createSchema = field.getZodSchema('embedding', 'create');
+            const updateSchema = field.getZodSchema('embedding', 'update');
+            const validEmbedding = {
+                vector: [0.1, 0.2, 0.3],
+                metadata: {
+                    model: 'test',
+                    provider: 'test',
+                    dimensions: 3,
+                    generatedAt: new Date().toISOString(),
+                },
+            };
+            expect(() => createSchema.parse(validEmbedding)).not.toThrow();
+            expect(() => updateSchema.parse(validEmbedding)).not.toThrow();
+        });
+    });
+    describe('getPrismaType', () => {
+        it('should return Json type', () => {
+            const field = embedding();
+            const prismaType = field.getPrismaType('embedding');
+            expect(prismaType.type).toBe('Json');
+        });
+        it('should return optional modifier', () => {
+            const field = embedding();
+            const prismaType = field.getPrismaType('embedding');
+            expect(prismaType.modifiers).toBe('?');
+        });
+        it('should work regardless of field options', () => {
+            const field1 = embedding();
+            const field2 = embedding({ dimensions: 3072, provider: 'openai' });
+            const type1 = field1.getPrismaType('embedding');
+            const type2 = field2.getPrismaType('embedding');
+            expect(type1).toEqual(type2);
+            expect(type1.type).toBe('Json');
+            expect(type1.modifiers).toBe('?');
+        });
+    });
+    describe('getTypeScriptType', () => {
+        it('should return StoredEmbedding type', () => {
+            const field = embedding();
+            const tsType = field.getTypeScriptType();
+            expect(tsType.type).toBe('StoredEmbedding | null');
+        });
+        it('should be optional', () => {
+            const field = embedding();
+            const tsType = field.getTypeScriptType();
+            expect(tsType.optional).toBe(true);
+        });
+        it('should work regardless of field options', () => {
+            const field1 = embedding();
+            const field2 = embedding({ dimensions: 3072, provider: 'openai' });
+            const type1 = field1.getTypeScriptType();
+            const type2 = field2.getTypeScriptType();
+            expect(type1).toEqual(type2);
+            expect(type1.type).toBe('StoredEmbedding | null');
+            expect(type1.optional).toBe(true);
+        });
+    });
+    describe('Field configuration combinations', () => {
+        it('should support manual embedding storage', () => {
+            const field = embedding({
+                dimensions: 1536,
+                provider: 'openai',
+            });
+            expect(field.autoGenerate).toBe(false);
+            expect(field.sourceField).toBeUndefined();
+            expect(field.dimensions).toBe(1536);
+            expect(field.provider).toBe('openai');
+        });
+        it('should support automatic embedding generation', () => {
+            const field = embedding({
+                sourceField: 'content',
+                provider: 'openai',
+                dimensions: 1536,
+                autoGenerate: true,
+            });
+            expect(field.autoGenerate).toBe(true);
+            expect(field.sourceField).toBe('content');
+            expect(field.dimensions).toBe(1536);
+            expect(field.provider).toBe('openai');
+        });
+        it('should support chunking for long documents', () => {
+            const field = embedding({
+                sourceField: 'content',
+                chunking: {
+                    strategy: 'recursive',
+                    maxTokens: 500,
+                    overlap: 50,
+                },
+            });
+            expect(field.chunking?.strategy).toBe('recursive');
+            expect(field.chunking?.maxTokens).toBe(500);
+            expect(field.chunking?.overlap).toBe(50);
+        });
+        it('should support multiple providers via provider name', () => {
+            const openaiField = embedding({ provider: 'openai' });
+            const ollamaField = embedding({ provider: 'ollama' });
+            expect(openaiField.provider).toBe('openai');
+            expect(ollamaField.provider).toBe('ollama');
+        });
+    });
+    describe('Field type conformance', () => {
+        it('should conform to BaseFieldConfig interface', () => {
+            const field = embedding();
+            expect(field).toHaveProperty('type');
+            expect(field).toHaveProperty('getZodSchema');
+            expect(field).toHaveProperty('getPrismaType');
+            expect(field).toHaveProperty('getTypeScriptType');
+        });
+        it('should have all required builder methods', () => {
+            const field = embedding();
+            expect(typeof field.getZodSchema).toBe('function');
+            expect(typeof field.getPrismaType).toBe('function');
+            expect(typeof field.getTypeScriptType).toBe('function');
+        });
+        it('should return consistent types across methods', () => {
+            const field = embedding({ dimensions: 1536 });
+            const zodSchema = field.getZodSchema('embedding', 'create');
+            const prismaType = field.getPrismaType('embedding');
+            const tsType = field.getTypeScriptType();
+            // All methods should be callable and return valid results
+            expect(zodSchema).toBeDefined();
+            expect(prismaType).toBeDefined();
+            expect(tsType).toBeDefined();
+            // Types should be consistent (Json in Prisma, StoredEmbedding in TS)
+            expect(prismaType.type).toBe('Json');
+            expect(tsType.type).toContain('StoredEmbedding');
+        });
+    });
+    describe('UI configuration', () => {
+        it('should default to hiding vector display', () => {
+            const field = embedding();
+            expect(field.ui?.showVector).toBeUndefined();
+        });
+        it('should allow showing vector in UI', () => {
+            const field = embedding({
+                ui: { showVector: true },
+            });
+            expect(field.ui?.showVector).toBe(true);
+        });
+        it('should default to showing metadata', () => {
+            const field = embedding();
+            expect(field.ui?.showMetadata).toBeUndefined();
+        });
+        it('should allow customizing metadata display', () => {
+            const field = embedding({
+                ui: { showMetadata: false },
+            });
+            expect(field.ui?.showMetadata).toBe(false);
+        });
+    });
+    describe('Edge cases', () => {
+        it('should handle very large dimensions', () => {
+            const field = embedding({ dimensions: 10000 });
+            expect(field.dimensions).toBe(10000);
+            const schema = field.getZodSchema('embedding', 'create');
+            const largeVector = Array(10000).fill(0.1);
+            const validEmbedding = {
+                vector: largeVector,
+                metadata: {
+                    model: 'test',
+                    provider: 'test',
+                    dimensions: 10000,
+                    generatedAt: new Date().toISOString(),
+                },
+            };
+            expect(() => schema.parse(validEmbedding)).not.toThrow();
+        });
+        it('should handle minimum dimensions', () => {
+            const field = embedding({ dimensions: 1 });
+            expect(field.dimensions).toBe(1);
+            const schema = field.getZodSchema('embedding', 'create');
+            const validEmbedding = {
+                vector: [0.5],
+                metadata: {
+                    model: 'test',
+                    provider: 'test',
+                    dimensions: 1,
+                    generatedAt: new Date().toISOString(),
+                },
+            };
+            expect(() => schema.parse(validEmbedding)).not.toThrow();
+        });
+        it('should handle empty sourceField gracefully', () => {
+            const field = embedding({ sourceField: '' });
+            expect(field.sourceField).toBe('');
+            // Empty string is truthy (it's a defined value), so autoGenerate will be true
+            // unless explicitly set to false
+            expect(field.autoGenerate).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=embedding.test.js.map

package/dist/fields/embedding.test.js.map

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

package/dist/fields/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * RAG field types
+ */
+export { embedding } from './embedding.js';
+export type { EmbeddingField } from './embedding.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/fields/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fields/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/fields/index.js

@@ -0,0 +1,5 @@
+/**
+ * RAG field types
+ */
+export { embedding } from './embedding.js';
+//# sourceMappingURL=index.js.map

package/dist/fields/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fields/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @opensaas/stack-rag
+ * RAG and AI embeddings integration for OpenSaas Stack
+ */
+export { openaiEmbeddings, ollamaEmbeddings, pgvectorStorage, sqliteVssStorage, jsonStorage, } from './config/index.js';
+export { ragPlugin } from './config/plugin.js';
+export type { RAGConfig, NormalizedRAGConfig, EmbeddingProviderConfig, OpenAIEmbeddingConfig, OllamaEmbeddingConfig, VectorStorageConfig, PgVectorStorageConfig, SqliteVssStorageConfig, JsonStorageConfig, ChunkingConfig, ChunkingStrategy, EmbeddingMetadata, StoredEmbedding, SearchResult, } from './config/types.js';
+//# 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":"AAAA;;;GAGG;AAGH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,WAAW,GACZ,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAE9C,YAAY,EACV,SAAS,EACT,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,YAAY,GACb,MAAM,mBAAmB,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @opensaas/stack-rag
+ * RAG and AI embeddings integration for OpenSaas Stack
+ */
+// Config exports
+export { openaiEmbeddings, ollamaEmbeddings, pgvectorStorage, sqliteVssStorage, jsonStorage, } from './config/index.js';
+// Plugin export
+export { ragPlugin } from './config/plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iBAAiB;AACjB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,WAAW,GACZ,MAAM,mBAAmB,CAAA;AAE1B,gBAAgB;AAChB,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * MCP (Model Context Protocol) integration for RAG
+ *
+ * MCP tools for semantic search are automatically generated by the ragPlugin.
+ * This export is provided for future extensibility and custom MCP tool generation.
+ */
+export type { SearchResult } from '../config/types.js';
+export type { SemanticSearchOptions } from '../runtime/search.js';
+/**
+ * MCP tools are automatically generated by ragPlugin when:
+ * - MCP is enabled in main config
+ * - ragPlugin has enableMcpTools: true (default)
+ *
+ * Generated tools:
+ * - semantic_search_{listKey} - Search by natural language query
+ *
+ * See packages/rag/src/config/plugin.ts for implementation details.
+ */
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAEjE;;;;;;;;;GASG"}

package/dist/mcp/index.js

@@ -0,0 +1,18 @@
+/**
+ * MCP (Model Context Protocol) integration for RAG
+ *
+ * MCP tools for semantic search are automatically generated by the ragPlugin.
+ * This export is provided for future extensibility and custom MCP tool generation.
+ */
+export {};
+/**
+ * MCP tools are automatically generated by ragPlugin when:
+ * - MCP is enabled in main config
+ * - ragPlugin has enableMcpTools: true (default)
+ *
+ * Generated tools:
+ * - semantic_search_{listKey} - Search by natural language query
+ *
+ * See packages/rag/src/config/plugin.ts for implementation details.
+ */
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;;AAMH;;;;;;;;;GASG"}

package/dist/providers/index.d.ts

@@ -0,0 +1,38 @@
+import type { EmbeddingProvider } from './types.js';
+import type { EmbeddingProviderConfig } from '../config/types.js';
+/**
+ * Register a custom embedding provider factory
+ * Use this to add support for custom embedding providers
+ *
+ * @example
+ * ```typescript
+ * import { registerEmbeddingProvider } from '@opensaas/stack-rag/providers'
+ *
+ * registerEmbeddingProvider('custom', (config) => {
+ *   return new CustomEmbeddingProvider(config)
+ * })
+ * ```
+ */
+export declare function registerEmbeddingProvider(type: string, factory: (config: EmbeddingProviderConfig) => EmbeddingProvider): void;
+/**
+ * Create an embedding provider instance from configuration
+ * Automatically selects the correct provider based on config.type
+ *
+ * @example
+ * ```typescript
+ * import { createEmbeddingProvider } from '@opensaas/stack-rag/providers'
+ *
+ * const provider = createEmbeddingProvider({
+ *   type: 'openai',
+ *   apiKey: process.env.OPENAI_API_KEY!,
+ *   model: 'text-embedding-3-small'
+ * })
+ *
+ * const embedding = await provider.embed('Hello world')
+ * ```
+ */
+export declare function createEmbeddingProvider(config: EmbeddingProviderConfig): EmbeddingProvider;
+export * from './types.js';
+export { OpenAIEmbeddingProvider, createOpenAIProvider } from './openai.js';
+export { OllamaEmbeddingProvider, createOllamaProvider } from './ollama.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AA0BjE;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,iBAAiB,GAC9D,IAAI,CAEN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAW1F;AAGD,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAC3E,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA"}

package/dist/providers/index.js

@@ -0,0 +1,68 @@
+import { createOpenAIProvider } from './openai.js';
+import { createOllamaProvider } from './ollama.js';
+/**
+ * Provider factory registry
+ * Maps provider types to factory functions
+ */
+const providerFactories = new Map();
+/**
+ * Register the built-in providers
+ */
+providerFactories.set('openai', (config) => {
+    if (config.type !== 'openai') {
+        throw new Error('Invalid config type for OpenAI provider');
+    }
+    return createOpenAIProvider(config);
+});
+providerFactories.set('ollama', (config) => {
+    if (config.type !== 'ollama') {
+        throw new Error('Invalid config type for Ollama provider');
+    }
+    return createOllamaProvider(config);
+});
+/**
+ * Register a custom embedding provider factory
+ * Use this to add support for custom embedding providers
+ *
+ * @example
+ * ```typescript
+ * import { registerEmbeddingProvider } from '@opensaas/stack-rag/providers'
+ *
+ * registerEmbeddingProvider('custom', (config) => {
+ *   return new CustomEmbeddingProvider(config)
+ * })
+ * ```
+ */
+export function registerEmbeddingProvider(type, factory) {
+    providerFactories.set(type, factory);
+}
+/**
+ * Create an embedding provider instance from configuration
+ * Automatically selects the correct provider based on config.type
+ *
+ * @example
+ * ```typescript
+ * import { createEmbeddingProvider } from '@opensaas/stack-rag/providers'
+ *
+ * const provider = createEmbeddingProvider({
+ *   type: 'openai',
+ *   apiKey: process.env.OPENAI_API_KEY!,
+ *   model: 'text-embedding-3-small'
+ * })
+ *
+ * const embedding = await provider.embed('Hello world')
+ * ```
+ */
+export function createEmbeddingProvider(config) {
+    const factory = providerFactories.get(config.type);
+    if (!factory) {
+        throw new Error(`Unknown embedding provider type: ${config.type}. ` +
+            `Available providers: ${Array.from(providerFactories.keys()).join(', ')}`);
+    }
+    return factory(config);
+}
+// Export types and individual providers
+export * from './types.js';
+export { OpenAIEmbeddingProvider, createOpenAIProvider } from './openai.js';
+export { OllamaEmbeddingProvider, createOllamaProvider } from './ollama.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAElD;;;GAGG;AACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAkE,CAAA;AAEnG;;GAEG;AACH,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;IACzC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;IAC5D,CAAC;IACD,OAAO,oBAAoB,CAAC,MAA4D,CAAC,CAAA;AAC3F,CAAC,CAAC,CAAA;AACF,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;IACzC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;IAC5D,CAAC;IACD,OAAO,oBAAoB,CAAC,MAA4D,CAAC,CAAA;AAC3F,CAAC,CAAC,CAAA;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,yBAAyB,CACvC,IAAY,EACZ,OAA+D;IAE/D,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAA+B;IACrE,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAElD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,oCAAoC,MAAM,CAAC,IAAI,IAAI;YACjD,wBAAwB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5E,CAAA;IACH,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC,CAAA;AACxB,CAAC;AAED,wCAAwC;AACxC,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAC3E,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA"}

package/dist/providers/ollama.d.ts

@@ -0,0 +1,49 @@
+import type { EmbeddingProvider } from './types.js';
+import type { OllamaEmbeddingConfig } from '../config/types.js';
+/**
+ * Ollama embedding provider
+ * Uses local Ollama instance for embedding generation
+ */
+export declare class OllamaEmbeddingProvider implements EmbeddingProvider {
+    readonly type = "ollama";
+    readonly model: string;
+    dimensions: number;
+    private baseURL;
+    private dimensionsInitialized;
+    constructor(config: OllamaEmbeddingConfig);
+    /**
+     * Initialize dimensions by generating a test embedding
+     */
+    private initializeDimensions;
+    /**
+     * Make HTTP request to Ollama API
+     */
+    private makeRequest;
+    /**
+     * Generate embedding for a single text
+     */
+    embed(text: string): Promise<number[]>;
+    /**
+     * Generate embeddings for multiple texts in a batch
+     * Note: Ollama doesn't have native batch API, so we make parallel requests
+     */
+    embedBatch(texts: string[]): Promise<number[][]>;
+}
+/**
+ * Create an Ollama embedding provider instance
+ *
+ * @example
+ * ```typescript
+ * import { createOllamaProvider } from '@opensaas/stack-rag/providers'
+ *
+ * const provider = createOllamaProvider({
+ *   type: 'ollama',
+ *   baseURL: 'http://localhost:11434',
+ *   model: 'nomic-embed-text'
+ * })
+ *
+ * const embedding = await provider.embed('Hello world')
+ * ```
+ */
+export declare function createOllamaProvider(config: OllamaEmbeddingConfig): OllamaEmbeddingProvider;
+//# sourceMappingURL=ollama.d.ts.map

package/dist/providers/ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../src/providers/ollama.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAa/D;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,QAAQ,CAAC,IAAI,YAAW;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAI;IAEtB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,qBAAqB,CAAQ;gBAEzB,MAAM,EAAE,qBAAqB;IAUzC;;OAEG;YACW,oBAAoB;IAgBlC;;OAEG;YACW,WAAW;IA0BzB;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAuB5C;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CAmDvD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,GAAG,uBAAuB,CAE3F"}