@hazeljs/rag 0.2.0-alpha.1

package/dist/decorators/embeddable.decorator.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * @Embeddable Decorator
+ * Automatically generates embeddings for entity fields
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Embeddable = Embeddable;
+exports.getEmbeddableMetadata = getEmbeddableMetadata;
+exports.VectorColumn = VectorColumn;
+exports.getVectorColumns = getVectorColumns;
+require("reflect-metadata");
+const EMBEDDABLE_METADATA_KEY = Symbol('embeddable');
+/**
+ * Marks an entity as embeddable with automatic embedding generation
+ */
+function Embeddable(options) {
+    return ((target) => {
+        Reflect.defineMetadata(EMBEDDABLE_METADATA_KEY, options, target);
+        return target;
+    });
+}
+/**
+ * Get embeddable metadata from a class
+ */
+function getEmbeddableMetadata(target) {
+    return Reflect.getMetadata(EMBEDDABLE_METADATA_KEY, target);
+}
+/**
+ * Marks a property as a vector column for storing embeddings
+ */
+function VectorColumn() {
+    return (target, propertyKey) => {
+        const vectorColumns = Reflect.getMetadata('vectorColumns', target.constructor) || [];
+        vectorColumns.push(propertyKey);
+        Reflect.defineMetadata('vectorColumns', vectorColumns, target.constructor);
+    };
+}
+/**
+ * Get vector column metadata
+ */
+function getVectorColumns(target) {
+    return Reflect.getMetadata('vectorColumns', target) || [];
+}
+//# sourceMappingURL=embeddable.decorator.js.map

package/dist/decorators/embeddable.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddable.decorator.js","sourceRoot":"","sources":["../../src/decorators/embeddable.decorator.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAmBH,gCAKC;AAKD,sDAEC;AAKD,oCAMC;AAKD,4CAEC;AA/CD,4BAA0B;AAY1B,MAAM,uBAAuB,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAErD;;GAEG;AACH,SAAgB,UAAU,CAAC,OAA0B;IACnD,OAAO,CAAC,CAAC,MAAuB,EAAE,EAAE;QAClC,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACjE,OAAO,MAAM,CAAC;IAChB,CAAC,CAAmB,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,MAAuB;IAC3D,OAAO,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY;IAC1B,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,EAAE;QACtD,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACrF,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAChC,OAAO,CAAC,cAAc,CAAC,eAAe,EAAE,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAC7E,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,MAAuB;IACtD,OAAO,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC5D,CAAC"}

package/dist/decorators/rag.decorator.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @RAG Module Decorator
+ * Configure RAG at module level
+ */
+import 'reflect-metadata';
+type NewableFunction = new (...args: unknown[]) => unknown;
+export interface RAGModuleOptions {
+    vectorDB?: 'pinecone' | 'weaviate' | 'qdrant' | 'chroma' | 'milvus' | 'pgvector' | 'redis' | 'memory';
+    embeddingModel?: string;
+    chunkSize?: number;
+    chunkOverlap?: number;
+    indexName?: string;
+    apiKey?: string;
+    endpoint?: string;
+    namespace?: string;
+}
+export interface ConversationalRAGOptions {
+    memoryType?: 'buffer' | 'summary' | 'window';
+    maxTokens?: number;
+    sessionStore?: 'memory' | 'redis' | 'database';
+}
+export interface MultiModalEmbeddingOptions {
+    models?: {
+        text?: string;
+        image?: string;
+        code?: string;
+    };
+}
+/**
+ * Configure RAG for a module
+ */
+export declare function RAG(options: RAGModuleOptions): ClassDecorator;
+/**
+ * Get RAG module configuration
+ */
+export declare function getRAGConfig(target: NewableFunction): RAGModuleOptions | undefined;
+/**
+ * Configure conversational RAG with memory
+ */
+export declare function ConversationalRAG(options: ConversationalRAGOptions): ClassDecorator;
+/**
+ * Configure multi-modal embeddings
+ */
+export declare function MultiModalEmbedding(options: MultiModalEmbeddingOptions): ClassDecorator;
+/**
+ * Embed image decorator
+ */
+export declare function EmbedImage(): MethodDecorator;
+/**
+ * Embed code decorator
+ */
+export declare function EmbedCode(): MethodDecorator;
+/**
+ * Cross-modal search decorator
+ */
+export declare function CrossModalSearch(): MethodDecorator;
+export {};
+//# sourceMappingURL=rag.decorator.d.ts.map

package/dist/decorators/rag.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/rag.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAE1B,KAAK,eAAe,GAAG,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EACL,UAAU,GACV,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,OAAO,GACP,QAAQ,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;CAChD;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAMD;;GAEG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,CAK7D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,GAAG,SAAS,CAElF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,cAAc,CAKnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,cAAc,CAKvF;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,eAAe,CAK5C;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,eAAe,CAK3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,CAKlD"}

package/dist/decorators/rag.decorator.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * @RAG Module Decorator
+ * Configure RAG at module level
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RAG = RAG;
+exports.getRAGConfig = getRAGConfig;
+exports.ConversationalRAG = ConversationalRAG;
+exports.MultiModalEmbedding = MultiModalEmbedding;
+exports.EmbedImage = EmbedImage;
+exports.EmbedCode = EmbedCode;
+exports.CrossModalSearch = CrossModalSearch;
+require("reflect-metadata");
+const RAG_MODULE_KEY = Symbol('ragModule');
+const CONVERSATIONAL_RAG_KEY = Symbol('conversationalRAG');
+const MULTIMODAL_EMBEDDING_KEY = Symbol('multiModalEmbedding');
+/**
+ * Configure RAG for a module
+ */
+function RAG(options) {
+    return ((target) => {
+        Reflect.defineMetadata(RAG_MODULE_KEY, options, target);
+        return target;
+    });
+}
+/**
+ * Get RAG module configuration
+ */
+function getRAGConfig(target) {
+    return Reflect.getMetadata(RAG_MODULE_KEY, target);
+}
+/**
+ * Configure conversational RAG with memory
+ */
+function ConversationalRAG(options) {
+    return ((target) => {
+        Reflect.defineMetadata(CONVERSATIONAL_RAG_KEY, options, target);
+        return target;
+    });
+}
+/**
+ * Configure multi-modal embeddings
+ */
+function MultiModalEmbedding(options) {
+    return ((target) => {
+        Reflect.defineMetadata(MULTIMODAL_EMBEDDING_KEY, options, target);
+        return target;
+    });
+}
+/**
+ * Embed image decorator
+ */
+function EmbedImage() {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata('embedImage', true, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Embed code decorator
+ */
+function EmbedCode() {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata('embedCode', true, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Cross-modal search decorator
+ */
+function CrossModalSearch() {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata('crossModalSearch', true, target, propertyKey);
+        return descriptor;
+    };
+}
+//# sourceMappingURL=rag.decorator.js.map

package/dist/decorators/rag.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag.decorator.js","sourceRoot":"","sources":["../../src/decorators/rag.decorator.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AA8CH,kBAKC;AAKD,oCAEC;AAKD,8CAKC;AAKD,kDAKC;AAKD,gCAKC;AAKD,8BAKC;AAKD,4CAKC;AA1GD,4BAA0B;AAqC1B,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;AAC3C,MAAM,sBAAsB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAC3D,MAAM,wBAAwB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAE/D;;GAEG;AACH,SAAgB,GAAG,CAAC,OAAyB;IAC3C,OAAO,CAAC,CAAC,MAAuB,EAAE,EAAE;QAClC,OAAO,CAAC,cAAc,CAAC,cAAc,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAmB,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,MAAuB;IAClD,OAAO,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,OAAiC;IACjE,OAAO,CAAC,CAAC,MAAuB,EAAE,EAAE;QAClC,OAAO,CAAC,cAAc,CAAC,sBAAsB,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAChE,OAAO,MAAM,CAAC;IAChB,CAAC,CAAmB,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,OAAmC;IACrE,OAAO,CAAC,CAAC,MAAuB,EAAE,EAAE;QAClC,OAAO,CAAC,cAAc,CAAC,wBAAwB,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAClE,OAAO,MAAM,CAAC;IAChB,CAAC,CAAmB,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU;IACxB,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,UAA8B,EAAE,EAAE;QACtF,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAChE,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS;IACvB,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,UAA8B,EAAE,EAAE;QACtF,OAAO,CAAC,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC/D,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB;IAC9B,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,UAA8B,EAAE,EAAE;QACtF,OAAO,CAAC,cAAc,CAAC,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACtE,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/semantic-search.decorator.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Semantic Search Decorators
+ * Enable semantic search capabilities on methods
+ */
+import 'reflect-metadata';
+export interface SemanticSearchOptions {
+    topK?: number;
+    minScore?: number;
+    includeMetadata?: boolean;
+    filter?: Record<string, unknown>;
+}
+export interface HybridSearchOptions extends SemanticSearchOptions {
+    vectorWeight?: number;
+    keywordWeight?: number;
+    algorithm?: 'rrf' | 'weighted' | 'linear';
+}
+/**
+ * Enables semantic search on a method
+ */
+export declare function SemanticSearch(options?: SemanticSearchOptions): MethodDecorator;
+/**
+ * Enables hybrid search (vector + keyword) on a method
+ */
+export declare function HybridSearch(options?: HybridSearchOptions): MethodDecorator;
+/**
+ * Auto-embed decorator for automatic embedding generation
+ */
+export declare function AutoEmbed(_fields?: string[]): MethodDecorator;
+/**
+ * Multi-query RAG decorator
+ */
+export declare function MultiQueryRAG(options?: {
+    queries?: number;
+}): MethodDecorator;
+/**
+ * Compress context decorator
+ */
+export declare function CompressContext(options?: {
+    maxTokens?: number;
+}): MethodDecorator;
+/**
+ * Self-query RAG with automatic metadata filtering
+ */
+export declare function SelfQueryRAG(): MethodDecorator;
+/**
+ * Rerank results decorator
+ */
+export declare function Rerank(options?: {
+    model?: string;
+    topN?: number;
+}): MethodDecorator;
+/**
+ * Parent-child document retrieval
+ */
+export declare function ParentChildRetrieval(): MethodDecorator;
+/**
+ * Ensemble retrieval combining multiple methods
+ */
+export declare function EnsembleRetrieval(options?: {
+    methods?: string[];
+    weights?: number[];
+}): MethodDecorator;
+/**
+ * Time-weighted retrieval favoring recent documents
+ */
+export declare function TimeWeightedRetrieval(options?: {
+    decayRate?: number;
+}): MethodDecorator;
+//# sourceMappingURL=semantic-search.decorator.d.ts.map

package/dist/decorators/semantic-search.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-search.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/semantic-search.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAE1B,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,mBAAoB,SAAQ,qBAAqB;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAC;CAC3C;AAKD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,eAAe,CAKnF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,eAAe,CAK/E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,eAAe,CAe7D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,eAAe,CAKjF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,eAAe,CAKrF;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,eAAe,CAK9C;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,eAAe,CAKvF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,eAAe,CAKtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACf,GACL,eAAe,CAKjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,eAAe,CAK3F"}

package/dist/decorators/semantic-search.decorator.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * Semantic Search Decorators
+ * Enable semantic search capabilities on methods
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SemanticSearch = SemanticSearch;
+exports.HybridSearch = HybridSearch;
+exports.AutoEmbed = AutoEmbed;
+exports.MultiQueryRAG = MultiQueryRAG;
+exports.CompressContext = CompressContext;
+exports.SelfQueryRAG = SelfQueryRAG;
+exports.Rerank = Rerank;
+exports.ParentChildRetrieval = ParentChildRetrieval;
+exports.EnsembleRetrieval = EnsembleRetrieval;
+exports.TimeWeightedRetrieval = TimeWeightedRetrieval;
+require("reflect-metadata");
+const SEMANTIC_SEARCH_KEY = Symbol('semanticSearch');
+const HYBRID_SEARCH_KEY = Symbol('hybridSearch');
+/**
+ * Enables semantic search on a method
+ */
+function SemanticSearch(options = {}) {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata(SEMANTIC_SEARCH_KEY, options, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Enables hybrid search (vector + keyword) on a method
+ */
+function HybridSearch(options = {}) {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata(HYBRID_SEARCH_KEY, options, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Auto-embed decorator for automatic embedding generation
+ */
+function AutoEmbed(_fields) {
+    return (target, propertyKey, descriptor) => {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const result = await originalMethod.apply(this, args);
+            // TODO: Implement automatic embedding generation
+            // This would integrate with the RAG service to generate embeddings
+            return result;
+        };
+        return descriptor;
+    };
+}
+/**
+ * Multi-query RAG decorator
+ */
+function MultiQueryRAG(options = {}) {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata('multiQueryRAG', options, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Compress context decorator
+ */
+function CompressContext(options = {}) {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata('compressContext', options, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Self-query RAG with automatic metadata filtering
+ */
+function SelfQueryRAG() {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata('selfQueryRAG', true, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Rerank results decorator
+ */
+function Rerank(options = {}) {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata('rerank', options, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Parent-child document retrieval
+ */
+function ParentChildRetrieval() {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata('parentChildRetrieval', true, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Ensemble retrieval combining multiple methods
+ */
+function EnsembleRetrieval(options = {}) {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata('ensembleRetrieval', options, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Time-weighted retrieval favoring recent documents
+ */
+function TimeWeightedRetrieval(options = {}) {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata('timeWeightedRetrieval', options, target, propertyKey);
+        return descriptor;
+    };
+}
+//# sourceMappingURL=semantic-search.decorator.js.map

package/dist/decorators/semantic-search.decorator.js.map

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

package/dist/embeddings/cohere-embeddings.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Cohere Embeddings Provider
+ * High-quality embeddings with multilingual support
+ */
+import { EmbeddingProvider } from '../types';
+export interface CohereEmbeddingsConfig {
+    apiKey: string;
+    model?: string;
+    inputType?: 'search_document' | 'search_query' | 'classification' | 'clustering';
+    truncate?: 'NONE' | 'START' | 'END';
+    batchSize?: number;
+}
+export declare class CohereEmbeddings implements EmbeddingProvider {
+    private client;
+    private model;
+    private inputType;
+    private truncate;
+    private batchSize;
+    private dimension;
+    constructor(config: CohereEmbeddingsConfig);
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+    getDimension(): number;
+    /**
+     * Get embedding dimension for a given model
+     */
+    private getModelDimension;
+    /**
+     * Create embeddings for search queries (optimized input type)
+     */
+    embedQuery(query: string): Promise<number[]>;
+}
+//# sourceMappingURL=cohere-embeddings.d.ts.map

package/dist/embeddings/cohere-embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cohere-embeddings.d.ts","sourceRoot":"","sources":["../../src/embeddings/cohere-embeddings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAQ7C,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,iBAAiB,GAAG,cAAc,GAAG,gBAAgB,GAAG,YAAY,CAAC;IACjF,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,sBAAsB;IAapC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAetC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAwBtD,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAcnD"}

package/dist/embeddings/cohere-embeddings.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * Cohere Embeddings Provider
+ * High-quality embeddings with multilingual support
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CohereEmbeddings = void 0;
+class CohereEmbeddings {
+    constructor(config) {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { CohereClient } = require('cohere-ai');
+        this.client = new CohereClient({ token: config.apiKey });
+        this.model = config.model || 'embed-english-v3.0';
+        this.inputType = config.inputType || 'search_document';
+        this.truncate = config.truncate || 'END';
+        this.batchSize = config.batchSize || 96;
+        // Set dimension based on model
+        this.dimension = this.getModelDimension(this.model);
+    }
+    async embed(text) {
+        try {
+            const response = await this.client.embed({
+                texts: [text],
+                model: this.model,
+                inputType: this.inputType,
+                truncate: this.truncate,
+            });
+            return response.embeddings[0];
+        }
+        catch (error) {
+            throw new Error(`Failed to generate Cohere embedding: ${error}`);
+        }
+    }
+    async embedBatch(texts) {
+        const embeddings = [];
+        // Process in batches
+        for (let i = 0; i < texts.length; i += this.batchSize) {
+            const batch = texts.slice(i, i + this.batchSize);
+            try {
+                const response = await this.client.embed({
+                    texts: batch,
+                    model: this.model,
+                    inputType: this.inputType,
+                    truncate: this.truncate,
+                });
+                embeddings.push(...response.embeddings);
+            }
+            catch (error) {
+                throw new Error(`Failed to generate Cohere batch embeddings: ${error}`);
+            }
+        }
+        return embeddings;
+    }
+    getDimension() {
+        return this.dimension;
+    }
+    /**
+     * Get embedding dimension for a given model
+     */
+    getModelDimension(model) {
+        const dimensions = {
+            'embed-english-v3.0': 1024,
+            'embed-english-light-v3.0': 384,
+            'embed-multilingual-v3.0': 1024,
+            'embed-multilingual-light-v3.0': 384,
+            'embed-english-v2.0': 4096,
+            'embed-english-light-v2.0': 1024,
+            'embed-multilingual-v2.0': 768,
+        };
+        return dimensions[model] || 1024;
+    }
+    /**
+     * Create embeddings for search queries (optimized input type)
+     */
+    async embedQuery(query) {
+        try {
+            const response = await this.client.embed({
+                texts: [query],
+                model: this.model,
+                inputType: 'search_query',
+                truncate: this.truncate,
+            });
+            return response.embeddings[0];
+        }
+        catch (error) {
+            throw new Error(`Failed to generate Cohere query embedding: ${error}`);
+        }
+    }
+}
+exports.CohereEmbeddings = CohereEmbeddings;
+//# sourceMappingURL=cohere-embeddings.js.map

package/dist/embeddings/cohere-embeddings.js.map

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

package/dist/embeddings/openai-embeddings.d.ts

@@ -0,0 +1,21 @@
+/**
+ * OpenAI Embeddings Provider
+ */
+import { EmbeddingProvider } from '../types';
+export interface OpenAIEmbeddingsConfig {
+    apiKey: string;
+    model?: string;
+    dimensions?: number;
+    batchSize?: number;
+}
+export declare class OpenAIEmbeddings implements EmbeddingProvider {
+    private client;
+    private model;
+    private dimensions;
+    private batchSize;
+    constructor(config: OpenAIEmbeddingsConfig);
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+    getDimension(): number;
+}
+//# sourceMappingURL=openai-embeddings.d.ts.map

package/dist/embeddings/openai-embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-embeddings.d.ts","sourceRoot":"","sources":["../../src/embeddings/openai-embeddings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAM7C,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,sBAAsB;IASpC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IActC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAuBtD,YAAY,IAAI,MAAM;CAGvB"}

package/dist/embeddings/openai-embeddings.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * OpenAI Embeddings Provider
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIEmbeddings = void 0;
+class OpenAIEmbeddings {
+    constructor(config) {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { OpenAI: OpenAIClass } = require('openai');
+        this.client = new OpenAIClass({ apiKey: config.apiKey });
+        this.model = config.model || 'text-embedding-3-small';
+        this.dimensions = config.dimensions || 1536;
+        this.batchSize = config.batchSize || 100;
+    }
+    async embed(text) {
+        try {
+            const response = await this.client.embeddings.create({
+                model: this.model,
+                input: text,
+                dimensions: this.dimensions,
+            });
+            return response.data[0].embedding;
+        }
+        catch (error) {
+            throw new Error(`Failed to generate embedding: ${error}`);
+        }
+    }
+    async embedBatch(texts) {
+        const embeddings = [];
+        // Process in batches
+        for (let i = 0; i < texts.length; i += this.batchSize) {
+            const batch = texts.slice(i, i + this.batchSize);
+            try {
+                const response = await this.client.embeddings.create({
+                    model: this.model,
+                    input: batch,
+                    dimensions: this.dimensions,
+                });
+                embeddings.push(...response.data.map((item) => item.embedding));
+            }
+            catch (error) {
+                throw new Error(`Failed to generate batch embeddings: ${error}`);
+            }
+        }
+        return embeddings;
+    }
+    getDimension() {
+        return this.dimensions;
+    }
+}
+exports.OpenAIEmbeddings = OpenAIEmbeddings;
+//# sourceMappingURL=openai-embeddings.js.map

package/dist/embeddings/openai-embeddings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-embeddings.js","sourceRoot":"","sources":["../../src/embeddings/openai-embeddings.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAeH,MAAa,gBAAgB;IAM3B,YAAY,MAA8B;QACxC,iEAAiE;QACjE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,wBAAwB,CAAC;QACtD,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,GAAG,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;gBACnD,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK,EAAE,IAAI;gBACX,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,MAAM,UAAU,GAAe,EAAE,CAAC;QAElC,qBAAqB;QACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;YAEjD,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;oBACnD,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,KAAK,EAAE,KAAK;oBACZ,UAAU,EAAE,IAAI,CAAC,UAAU;iBAC5B,CAAC,CAAC;gBAEH,UAAU,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAA6B,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;YAC3F,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,wCAAwC,KAAK,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF;AAvDD,4CAuDC"}

package/dist/graph/community-detector.d.ts

@@ -0,0 +1,45 @@
+/**
+ * CommunityDetector
+ *
+ * Detects communities (clusters of closely-related entities) in the knowledge
+ * graph using the **Label Propagation Algorithm (LPA)**.
+ *
+ * Why LPA?
+ *  - O(V + E) per iteration → scales well to thousands of entities
+ *  - No parameters to tune (unlike Louvain's resolution parameter)
+ *  - Converges in ~5–10 iterations for most real-world graphs
+ *
+ * Algorithm:
+ *  1. Assign each entity its own unique community label.
+ *  2. Shuffle entity iteration order (breaks symmetry for better convergence).
+ *  3. Each entity adopts the most frequent label among its neighbours,
+ *     weighted by relationship strength.
+ *  4. Repeat until labels stabilise or max iterations reached.
+ *  5. Groups entities that share the same label into communities.
+ *
+ * Large-community splitting:
+ *  If a community exceeds `maxCommunitySize`, it is recursively split by
+ *  running LPA on the sub-graph of its members only.
+ */
+import type { GraphCommunity } from './graph.types';
+import type { GraphStore } from './knowledge-graph';
+export interface CommunityDetectorConfig {
+    maxIterations?: number;
+    maxCommunitySize?: number;
+}
+export declare class CommunityDetector {
+    private readonly maxIterations;
+    private readonly maxCommunitySize;
+    constructor(config?: CommunityDetectorConfig);
+    /**
+     * Run community detection on the full graph.
+     * Returns a flat list of GraphCommunity objects (level 0 = leaf communities).
+     */
+    detect(graph: GraphStore): GraphCommunity[];
+    private buildWeightedAdjacency;
+    private runLPA;
+    private groupByLabel;
+    private splitOversized;
+    private shuffle;
+}
+//# sourceMappingURL=community-detector.d.ts.map

package/dist/graph/community-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"community-detector.d.ts","sourceRoot":"","sources":["../../src/graph/community-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,uBAAuB;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,MAAM,GAAE,uBAA4B;IAKhD;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,EAAE;IAsB3C,OAAO,CAAC,sBAAsB;IAqB9B,OAAO,CAAC,MAAM;IA8Cd,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,cAAc;IAkCtB,OAAO,CAAC,OAAO;CAOhB"}