@venturekit-pro/ai 0.0.0-dev.20260323005827

package/dist/rag/pipeline.js

@@ -0,0 +1,79 @@
+/**
+ * RAG Pipeline
+ *
+ * End-to-end retrieval-augmented generation pipeline.
+ */
+import { createEmbedder } from '../embeddings/embedder.js';
+import { createVectorStore } from '../vectors/store.js';
+import { chunkText } from './chunker.js';
+/**
+ * Create a RAG pipeline
+ */
+export function createRagPipeline(config) {
+    const embedder = createEmbedder(config.embedding);
+    const vectorStore = createVectorStore(config.vectorStore);
+    return {
+        async index(documents) {
+            const allChunks = [];
+            // Chunk all documents
+            for (const doc of documents) {
+                const chunks = chunkText(doc.content, doc.id, config.chunking);
+                for (const chunk of chunks) {
+                    chunk.metadata = { ...chunk.metadata, ...doc.metadata };
+                }
+                allChunks.push(...chunks);
+            }
+            // Generate embeddings
+            const texts = allChunks.map(c => c.content);
+            const { embeddings } = await embedder.embedBatch(texts);
+            // Store vectors
+            const vectors = allChunks.map((chunk, i) => ({
+                id: chunk.id,
+                values: embeddings[i],
+                metadata: {
+                    content: chunk.content,
+                    sourceId: chunk.sourceId,
+                    chunkIndex: chunk.chunkIndex,
+                    ...chunk.metadata,
+                },
+            }));
+            await vectorStore.upsert(vectors);
+        },
+        async retrieve(query, options) {
+            // Embed query
+            const { embedding } = await embedder.embed(query);
+            // Search vectors
+            const results = await vectorStore.search({
+                vector: embedding,
+                topK: options?.topK || config.topK,
+                filter: options?.filter,
+                includeMetadata: true,
+                minScore: config.minScore,
+            });
+            // Build context
+            const chunks = results.map(r => ({
+                content: r.metadata?.content || '',
+                score: r.score,
+                metadata: options?.includeMetadata ? r.metadata : undefined,
+            }));
+            const context = chunks.map(c => c.content).join('\n\n');
+            return {
+                chunks,
+                context,
+                totalChunks: chunks.length,
+            };
+        },
+        async delete(ids) {
+            // Delete all chunks for each document
+            const chunkIds = [];
+            for (const id of ids) {
+                // Assume up to 100 chunks per document
+                for (let i = 0; i < 100; i++) {
+                    chunkIds.push(`${id}-${i}`);
+                }
+            }
+            await vectorStore.delete(chunkIds);
+        },
+    };
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/rag/pipeline.js.map

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

package/dist/types/agents.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Agent Types
+ */
+/**
+ * LLM provider for agents
+ */
+export type LLMProvider = 'openai' | 'anthropic' | 'bedrock';
+/**
+ * Tool definition for agents
+ */
+export interface Tool {
+    /** Tool name */
+    name: string;
+    /** Tool description (for LLM) */
+    description: string;
+    /** JSON schema for parameters */
+    parameters: {
+        type: 'object';
+        properties: Record<string, {
+            type: string;
+            description: string;
+            enum?: string[];
+        }>;
+        required?: string[];
+    };
+    /** Tool execution function */
+    execute: (params: Record<string, unknown>) => Promise<unknown>;
+}
+/**
+ * Agent configuration
+ */
+export interface AgentConfig {
+    /** LLM provider */
+    provider: LLMProvider;
+    /** Model name */
+    model: string;
+    /** System prompt */
+    systemPrompt?: string;
+    /** Available tools */
+    tools?: Tool[];
+    /** Max iterations for tool use */
+    maxIterations?: number;
+    /** Temperature (0-1) */
+    temperature?: number;
+    /** API key */
+    apiKey?: string;
+    /** AWS region (for Bedrock) */
+    region?: string;
+}
+/**
+ * Agent config input (partial for overrides)
+ */
+export interface AgentConfigInput {
+    provider?: LLMProvider;
+    model?: string;
+    systemPrompt?: string;
+    tools?: Tool[];
+    maxIterations?: number;
+    temperature?: number;
+    apiKey?: string;
+    region?: string;
+}
+/**
+ * Chat message
+ */
+export interface ChatMessage {
+    /** Role */
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    /** Content */
+    content: string;
+    /** Tool call ID (for tool responses) */
+    toolCallId?: string;
+    /** Tool calls made by assistant */
+    toolCalls?: Array<{
+        id: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    }>;
+}
+/**
+ * Agent response
+ */
+export interface AgentResponse {
+    /** Final response content */
+    content: string;
+    /** Tool calls made during execution */
+    toolCalls?: Array<{
+        tool: string;
+        input: Record<string, unknown>;
+        output: unknown;
+    }>;
+    /** Number of iterations used */
+    iterations: number;
+    /** Tokens used */
+    tokensUsed?: {
+        prompt: number;
+        completion: number;
+        total: number;
+    };
+}
+/**
+ * Streaming chunk
+ */
+export interface StreamChunk {
+    /** Chunk type */
+    type: 'text' | 'tool_call' | 'tool_result' | 'done';
+    /** Text content (for text chunks) */
+    content?: string;
+    /** Tool call info */
+    toolCall?: {
+        id: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    };
+    /** Tool result */
+    toolResult?: unknown;
+}
+//# sourceMappingURL=agents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/types/agents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IAEb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IAEpB,iCAAiC;IACjC,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;YACzB,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;SACjB,CAAC,CAAC;QACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IAEF,8BAA8B;IAC9B,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAChE;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,QAAQ,EAAE,WAAW,CAAC;IAEtB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IAEd,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,sBAAsB;IACtB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IAEf,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW;IACX,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAE/C,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAEhB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,mCAAmC;IACnC,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,uCAAuC;IACvC,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;IAEH,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IAEnB,kBAAkB;IAClB,UAAU,CAAC,EAAE;QACX,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,aAAa,GAAG,MAAM,CAAC;IAEpD,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,qBAAqB;IACrB,QAAQ,CAAC,EAAE;QACT,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;IAEF,kBAAkB;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/dist/types/agents.js

@@ -0,0 +1,5 @@
+/**
+ * Agent Types
+ */
+export {};
+//# sourceMappingURL=agents.js.map

package/dist/types/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/types/agents.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/embeddings.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Embedding Types
+ */
+/**
+ * Embedding provider
+ */
+export type EmbeddingProvider = 'openai' | 'bedrock' | 'cohere' | 'custom';
+/**
+ * OpenAI embedding models
+ */
+export type OpenAIEmbeddingModel = 'text-embedding-3-small' | 'text-embedding-3-large' | 'text-embedding-ada-002';
+/**
+ * AWS Bedrock embedding models
+ */
+export type BedrockEmbeddingModel = 'amazon.titan-embed-text-v1' | 'amazon.titan-embed-text-v2:0' | 'cohere.embed-english-v3' | 'cohere.embed-multilingual-v3';
+/**
+ * Embedding configuration
+ */
+export interface EmbeddingConfig {
+    /** Provider to use */
+    provider: EmbeddingProvider;
+    /** Model name */
+    model: string;
+    /** Embedding dimensions (provider-specific) */
+    dimensions?: number;
+    /** API key (for OpenAI, Cohere) */
+    apiKey?: string;
+    /** AWS region (for Bedrock) */
+    region?: string;
+    /** Batch size for bulk operations */
+    batchSize?: number;
+    /** Max retries on failure */
+    maxRetries?: number;
+}
+/**
+ * Embedding config input (partial for overrides)
+ */
+export interface EmbeddingConfigInput {
+    provider?: EmbeddingProvider;
+    model?: string;
+    dimensions?: number;
+    apiKey?: string;
+    region?: string;
+    batchSize?: number;
+    maxRetries?: number;
+}
+/**
+ * Embedding result
+ */
+export interface EmbeddingResult {
+    /** The embedding vector */
+    embedding: number[];
+    /** Number of tokens used */
+    tokensUsed?: number;
+    /** Model used */
+    model: string;
+}
+/**
+ * Batch embedding result
+ */
+export interface BatchEmbeddingResult {
+    /** Embeddings in same order as input */
+    embeddings: number[][];
+    /** Total tokens used */
+    totalTokensUsed?: number;
+    /** Model used */
+    model: string;
+}
+//# sourceMappingURL=embeddings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/types/embeddings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,wBAAwB,GACxB,wBAAwB,GACxB,wBAAwB,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,4BAA4B,GAC5B,8BAA8B,GAC9B,yBAAyB,GACzB,8BAA8B,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sBAAsB;IACtB,QAAQ,EAAE,iBAAiB,CAAC;IAE5B,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IAEd,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC;IAEvB,wBAAwB;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/types/embeddings.js

@@ -0,0 +1,5 @@
+/**
+ * Embedding Types
+ */
+export {};
+//# sourceMappingURL=embeddings.js.map

package/dist/types/embeddings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../../src/types/embeddings.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AI Types
+ */
+export * from './embeddings.js';
+export * from './vectors.js';
+export * from './rag.js';
+export * from './agents.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,8 @@
+/**
+ * AI Types
+ */
+export * from './embeddings.js';
+export * from './vectors.js';
+export * from './rag.js';
+export * from './agents.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/types/rag.d.ts

@@ -0,0 +1,92 @@
+/**
+ * RAG (Retrieval-Augmented Generation) Types
+ */
+import type { EmbeddingConfig } from './embeddings.js';
+import type { VectorStoreConfig } from './vectors.js';
+/**
+ * Document chunk for indexing
+ */
+export interface DocumentChunk {
+    /** Unique identifier */
+    id: string;
+    /** Text content */
+    content: string;
+    /** Source document ID */
+    sourceId?: string;
+    /** Chunk index within source */
+    chunkIndex?: number;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Chunking strategy
+ */
+export type ChunkingStrategy = 'fixed' | 'sentence' | 'paragraph' | 'semantic';
+/**
+ * Text chunking configuration
+ */
+export interface ChunkingConfig {
+    /** Chunking strategy */
+    strategy: ChunkingStrategy;
+    /** Target chunk size (characters) */
+    chunkSize: number;
+    /** Overlap between chunks (characters) */
+    chunkOverlap: number;
+    /** Separator for fixed chunking */
+    separator?: string;
+}
+/**
+ * RAG configuration
+ */
+export interface RagConfig {
+    /** Embedding configuration */
+    embedding: EmbeddingConfig;
+    /** Vector store configuration */
+    vectorStore: VectorStoreConfig;
+    /** Chunking configuration */
+    chunking: ChunkingConfig;
+    /** Number of chunks to retrieve */
+    topK: number;
+    /** Minimum similarity score */
+    minScore?: number;
+    /** Reranking enabled */
+    rerank?: boolean;
+}
+/**
+ * RAG config input (partial for overrides)
+ */
+export interface RagConfigInput {
+    embedding?: Partial<EmbeddingConfig>;
+    vectorStore?: Partial<VectorStoreConfig>;
+    chunking?: Partial<ChunkingConfig>;
+    topK?: number;
+    minScore?: number;
+    rerank?: boolean;
+}
+/**
+ * Retrieved context for generation
+ */
+export interface RetrievedContext {
+    /** Retrieved chunks */
+    chunks: Array<{
+        content: string;
+        score: number;
+        metadata?: Record<string, unknown>;
+    }>;
+    /** Combined context string */
+    context: string;
+    /** Total chunks retrieved */
+    totalChunks: number;
+}
+/**
+ * RAG query options
+ */
+export interface RagQueryOptions {
+    /** Override topK for this query */
+    topK?: number;
+    /** Metadata filter */
+    filter?: Record<string, unknown>;
+    /** Include source metadata */
+    includeMetadata?: boolean;
+}
+//# sourceMappingURL=rag.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rag.d.ts","sourceRoot":"","sources":["../../src/types/rag.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IAEX,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAEhB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,QAAQ,EAAE,gBAAgB,CAAC;IAE3B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAElB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IAErB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,SAAS,EAAE,eAAe,CAAC;IAE3B,iCAAiC;IACjC,WAAW,EAAE,iBAAiB,CAAC;IAE/B,6BAA6B;IAC7B,QAAQ,EAAE,cAAc,CAAC;IAEzB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IAEb,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,wBAAwB;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,MAAM,EAAE,KAAK,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC,CAAC;IAEH,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAEhB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC,8BAA8B;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B"}

package/dist/types/rag.js

@@ -0,0 +1,5 @@
+/**
+ * RAG (Retrieval-Augmented Generation) Types
+ */
+export {};
+//# sourceMappingURL=rag.js.map

package/dist/types/rag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag.js","sourceRoot":"","sources":["../../src/types/rag.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/vectors.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Vector Store Types
+ */
+/**
+ * Vector store provider
+ */
+export type VectorStoreProvider = 'pinecone' | 'pgvector' | 'qdrant' | 'weaviate' | 'memory';
+/**
+ * Vector with metadata
+ */
+export interface Vector {
+    /** Unique identifier */
+    id: string;
+    /** The embedding vector */
+    values: number[];
+    /** Associated metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Vector store configuration
+ */
+export interface VectorStoreConfig {
+    /** Provider to use */
+    provider: VectorStoreProvider;
+    /** Index/collection name */
+    indexName: string;
+    /** Vector dimensions */
+    dimensions: number;
+    /** Distance metric */
+    metric?: 'cosine' | 'euclidean' | 'dotproduct';
+    /** Pinecone-specific */
+    pinecone?: {
+        apiKey: string;
+        environment?: string;
+    };
+    /** pgvector-specific */
+    pgvector?: {
+        connectionString: string;
+        tableName?: string;
+    };
+    /** Qdrant-specific */
+    qdrant?: {
+        url: string;
+        apiKey?: string;
+    };
+}
+/**
+ * Vector store config input (partial for overrides)
+ */
+export interface VectorStoreConfigInput {
+    provider?: VectorStoreProvider;
+    indexName?: string;
+    dimensions?: number;
+    metric?: 'cosine' | 'euclidean' | 'dotproduct';
+    pinecone?: {
+        apiKey: string;
+        environment?: string;
+    };
+    pgvector?: {
+        connectionString: string;
+        tableName?: string;
+    };
+    qdrant?: {
+        url: string;
+        apiKey?: string;
+    };
+}
+/**
+ * Vector search query
+ */
+export interface VectorQuery {
+    /** Query vector */
+    vector: number[];
+    /** Number of results to return */
+    topK: number;
+    /** Metadata filter */
+    filter?: Record<string, unknown>;
+    /** Include metadata in results */
+    includeMetadata?: boolean;
+    /** Include vectors in results */
+    includeValues?: boolean;
+    /** Minimum similarity score (0-1) */
+    minScore?: number;
+}
+/**
+ * Vector search result
+ */
+export interface VectorSearchResult {
+    /** Vector ID */
+    id: string;
+    /** Similarity score */
+    score: number;
+    /** Metadata if requested */
+    metadata?: Record<string, unknown>;
+    /** Vector values if requested */
+    values?: number[];
+}
+//# sourceMappingURL=vectors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vectors.d.ts","sourceRoot":"","sources":["../../src/types/vectors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IAEX,2BAA2B;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sBAAsB;IACtB,QAAQ,EAAE,mBAAmB,CAAC;IAE9B,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAElB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IAEnB,sBAAsB;IACtB,MAAM,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,YAAY,CAAC;IAE/C,wBAAwB;IACxB,QAAQ,CAAC,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,wBAAwB;IACxB,QAAQ,CAAC,EAAE;QACT,gBAAgB,EAAE,MAAM,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,sBAAsB;IACtB,MAAM,CAAC,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,YAAY,CAAC;IAC/C,QAAQ,CAAC,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,gBAAgB,EAAE,MAAM,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IAEb,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC,kCAAkC;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,iCAAiC;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAC;IAEX,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IAEd,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/types/vectors.js

@@ -0,0 +1,5 @@
+/**
+ * Vector Store Types
+ */
+export {};
+//# sourceMappingURL=vectors.js.map

package/dist/types/vectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectors.js","sourceRoot":"","sources":["../../src/types/vectors.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/vectors/config.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Vector Store Configuration
+ */
+import type { VectorStoreConfig, VectorStoreConfigInput } from '../types/index.js';
+/**
+ * Default vector store configuration (in-memory for dev)
+ */
+export declare const DEFAULT_VECTOR_STORE_CONFIG: VectorStoreConfig;
+/**
+ * Create vector store configuration from input
+ */
+export declare function createVectorStoreConfig(input?: VectorStoreConfigInput): VectorStoreConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/vectors/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/vectors/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,iBAKzC,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,CAAC,EAAE,sBAAsB,GAAG,iBAAiB,CAOzF"}

package/dist/vectors/config.js

@@ -0,0 +1,24 @@
+/**
+ * Vector Store Configuration
+ */
+/**
+ * Default vector store configuration (in-memory for dev)
+ */
+export const DEFAULT_VECTOR_STORE_CONFIG = {
+    provider: 'memory',
+    indexName: 'default',
+    dimensions: 1536,
+    metric: 'cosine',
+};
+/**
+ * Create vector store configuration from input
+ */
+export function createVectorStoreConfig(input) {
+    if (!input)
+        return DEFAULT_VECTOR_STORE_CONFIG;
+    return {
+        ...DEFAULT_VECTOR_STORE_CONFIG,
+        ...input,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/vectors/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/vectors/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAsB;IAC5D,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,IAAI;IAChB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAA8B;IACpE,IAAI,CAAC,KAAK;QAAE,OAAO,2BAA2B,CAAC;IAE/C,OAAO;QACL,GAAG,2BAA2B;QAC9B,GAAG,KAAK;KACT,CAAC;AACJ,CAAC"}

package/dist/vectors/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Vector Store
+ *
+ * Utilities for vector storage and similarity search.
+ */
+export { createVectorStoreConfig, DEFAULT_VECTOR_STORE_CONFIG } from './config.js';
+export { createVectorStore } from './store.js';
+export type { VectorStore } from './store.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vectors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/vectors/index.js

@@ -0,0 +1,8 @@
+/**
+ * Vector Store
+ *
+ * Utilities for vector storage and similarity search.
+ */
+export { createVectorStoreConfig, DEFAULT_VECTOR_STORE_CONFIG } from './config.js';
+export { createVectorStore } from './store.js';
+//# sourceMappingURL=index.js.map

package/dist/vectors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vectors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/vectors/store.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Vector Store
+ *
+ * Unified interface for vector storage across providers.
+ */
+import type { VectorStoreConfig, Vector, VectorQuery, VectorSearchResult } from '../types/index.js';
+/**
+ * Vector store interface
+ */
+export interface VectorStore {
+    /** Upsert vectors */
+    upsert(vectors: Vector[]): Promise<void>;
+    /** Search for similar vectors */
+    search(query: VectorQuery): Promise<VectorSearchResult[]>;
+    /** Delete vectors by ID */
+    delete(ids: string[]): Promise<void>;
+    /** Get vectors by ID */
+    fetch(ids: string[]): Promise<Vector[]>;
+}
+/**
+ * Create a vector store for the configured provider
+ */
+export declare function createVectorStore(config: VectorStoreConfig): VectorStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/vectors/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/vectors/store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEpG;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qBAAqB;IACrB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,iCAAiC;IACjC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAE1D,2BAA2B;IAC3B,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,wBAAwB;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAWxE"}