@venturekit/ai 0.0.0-dev.20260307234057

package/dist/types/index.js

@@ -0,0 +1,8 @@
+/**
+ * AI Types
+ */
+export * from './embeddings';
+export * from './vectors';
+export * from './rag';
+export * from './agents';
+//# 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,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC"}

package/dist/types/rag.d.ts

@@ -0,0 +1,92 @@
+/**
+ * RAG (Retrieval-Augmented Generation) Types
+ */
+import type { EmbeddingConfig } from './embeddings';
+import type { VectorStoreConfig } from './vectors';
+/**
+ * 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,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD;;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';
+/**
+ * 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,UAAU,CAAC;AAE1E;;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';
+export { createVectorStore } from './store';
+export type { VectorStore } from './store';
+//# 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,UAAU,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,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';
+export { createVectorStore } from './store';
+//# 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,UAAU,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,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';
+/**
+ * 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,UAAU,CAAC;AAE3F;;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"}

package/dist/vectors/store.js

@@ -0,0 +1,156 @@
+/**
+ * Vector Store
+ *
+ * Unified interface for vector storage across providers.
+ */
+/**
+ * Create a vector store for the configured provider
+ */
+export function createVectorStore(config) {
+    switch (config.provider) {
+        case 'memory':
+            return createMemoryStore(config);
+        case 'pinecone':
+            return createPineconeStore(config);
+        case 'pgvector':
+            return createPgVectorStore(config);
+        default:
+            throw new Error(`Unsupported vector store provider: ${config.provider}`);
+    }
+}
+/**
+ * In-memory vector store (for development/testing)
+ */
+function createMemoryStore(config) {
+    const vectors = new Map();
+    return {
+        async upsert(newVectors) {
+            for (const v of newVectors) {
+                vectors.set(v.id, v);
+            }
+        },
+        async search(query) {
+            const results = [];
+            for (const [id, vector] of vectors) {
+                const score = cosineSimilarity(query.vector, vector.values);
+                if (query.minScore && score < query.minScore)
+                    continue;
+                results.push({
+                    id,
+                    score,
+                    metadata: query.includeMetadata ? vector.metadata : undefined,
+                    values: query.includeValues ? vector.values : undefined,
+                });
+            }
+            return results
+                .sort((a, b) => b.score - a.score)
+                .slice(0, query.topK);
+        },
+        async delete(ids) {
+            for (const id of ids) {
+                vectors.delete(id);
+            }
+        },
+        async fetch(ids) {
+            return ids
+                .map(id => vectors.get(id))
+                .filter((v) => v !== undefined);
+        },
+    };
+}
+/**
+ * Pinecone vector store
+ */
+function createPineconeStore(config) {
+    if (!config.pinecone?.apiKey) {
+        throw new Error('Pinecone API key is required');
+    }
+    return {
+        async upsert(vectors) {
+            const { Pinecone } = await import('@pinecone-database/pinecone');
+            const client = new Pinecone({ apiKey: config.pinecone.apiKey });
+            const index = client.index(config.indexName);
+            await index.upsert(vectors.map(v => ({
+                id: v.id,
+                values: v.values,
+                metadata: v.metadata,
+            })));
+        },
+        async search(query) {
+            const { Pinecone } = await import('@pinecone-database/pinecone');
+            const client = new Pinecone({ apiKey: config.pinecone.apiKey });
+            const index = client.index(config.indexName);
+            const results = await index.query({
+                vector: query.vector,
+                topK: query.topK,
+                includeMetadata: query.includeMetadata,
+                includeValues: query.includeValues,
+                filter: query.filter,
+            });
+            return (results.matches || [])
+                .filter(m => !query.minScore || (m.score && m.score >= query.minScore))
+                .map(m => ({
+                id: m.id,
+                score: m.score || 0,
+                metadata: m.metadata,
+                values: m.values,
+            }));
+        },
+        async delete(ids) {
+            const { Pinecone } = await import('@pinecone-database/pinecone');
+            const client = new Pinecone({ apiKey: config.pinecone.apiKey });
+            const index = client.index(config.indexName);
+            await index.deleteMany(ids);
+        },
+        async fetch(ids) {
+            const { Pinecone } = await import('@pinecone-database/pinecone');
+            const client = new Pinecone({ apiKey: config.pinecone.apiKey });
+            const index = client.index(config.indexName);
+            const results = await index.fetch(ids);
+            return Object.entries(results.records || {}).map(([id, record]) => ({
+                id,
+                values: record.values,
+                metadata: record.metadata,
+            }));
+        },
+    };
+}
+/**
+ * pgvector store (PostgreSQL)
+ */
+function createPgVectorStore(config) {
+    if (!config.pgvector?.connectionString) {
+        throw new Error('pgvector connection string is required');
+    }
+    const tableName = config.pgvector.tableName || 'vectors';
+    return {
+        async upsert(_vectors) {
+            // Implementation requires pg client
+            throw new Error('pgvector upsert requires pg client - use with your database connection');
+        },
+        async search(_query) {
+            throw new Error('pgvector search requires pg client - use with your database connection');
+        },
+        async delete(_ids) {
+            throw new Error('pgvector delete requires pg client - use with your database connection');
+        },
+        async fetch(_ids) {
+            throw new Error('pgvector fetch requires pg client - use with your database connection');
+        },
+    };
+}
+/**
+ * Calculate cosine similarity between two vectors
+ */
+function cosineSimilarity(a, b) {
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    return dotProduct / (Math.sqrt(normA) * Math.sqrt(normB));
+}
+//# sourceMappingURL=store.js.map

package/dist/vectors/store.js.map

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

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@venturekit/ai",
+  "version": "0.0.0-dev.20260307234057",
+  "description": "AI utilities for VentureKit - embeddings, RAG, and agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/venturekit-dev/venturekit.private.git",
+    "directory": "packages/ai"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "license": "Apache-2.0",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "keywords": [
+    "venturekit",
+    "saas",
+    "ai",
+    "embeddings",
+    "rag"
+  ],
+  "dependencies": {
+    "@venturekit/core": "0.0.0-dev.20260307234057"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-bedrock-runtime": "^3.0.0",
+    "@pinecone-database/pinecone": "^4.0.0",
+    "openai": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@aws-sdk/client-bedrock-runtime": {
+      "optional": true
+    },
+    "@pinecone-database/pinecone": {
+      "optional": true
+    },
+    "openai": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@pinecone-database/pinecone": "^4.0.0",
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  }
+}