@framers/agentos 0.6.29 → 0.7.0

package/dist/cognition/rag/multimodal/types.d.ts

@@ -0,0 +1,332 @@
+/**
+ * @module rag/multimodal/types
+ *
+ * Type definitions for the multimodal RAG indexing system.
+ *
+ * The multimodal indexer extends the text-only RAG pipeline to handle
+ * non-text content (images, audio) by converting them to text
+ * representations (descriptions, transcripts) and embedding those
+ * representations into the shared vector store.
+ *
+ * ## Modality architecture
+ *
+ * Each indexed document carries a `modality` metadata field:
+ * - `'text'` — standard text documents (existing RAG pipeline)
+ * - `'image'` — vision LLM-generated descriptions of images
+ * - `'audio'` — STT-generated transcripts of audio files
+ *
+ * During search, results can be filtered by modality or searched
+ * across all modalities simultaneously.
+ *
+ * @see {@link MultimodalIndexer} for the implementation.
+ * @see {@link IVectorStore} for the underlying storage.
+ * @see {@link IEmbeddingManager} for embedding generation.
+ */
+/**
+ * Supported content modalities in the multimodal RAG system.
+ *
+ * - `'text'` — Standard text content (documents, web pages, etc.)
+ * - `'image'` — Visual content indexed via vision LLM descriptions
+ * - `'audio'` — Audio content indexed via STT transcripts
+ */
+export type ContentModality = 'text' | 'image' | 'audio';
+/**
+ * Options for indexing an image into the vector store.
+ *
+ * The image is described by a vision-capable LLM, then the description
+ * is embedded and stored alongside the original image reference.
+ *
+ * @example
+ * ```typescript
+ * const result = await indexer.indexImage({
+ *   image: fs.readFileSync('./photo.jpg'),
+ *   metadata: { source: 'user-upload', fileName: 'photo.jpg' },
+ *   collection: 'user-images',
+ * });
+ * ```
+ */
+export interface ImageIndexOptions {
+    /**
+     * Image data as a URL string (file:// or https://) or a raw Buffer.
+     * - URL: Passed directly to the vision LLM for description.
+     * - Buffer: Converted to a base64 data URL before passing to the LLM.
+     */
+    image: string | Buffer;
+    /**
+     * Optional metadata to attach to the indexed document.
+     * Stored alongside the embedding for filtering during search.
+     *
+     * @example { source: 'upload', tags: ['landscape', 'nature'] }
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Vector store collection to index into.
+     * @default 'multimodal'
+     */
+    collection?: string;
+}
+/**
+ * Options for indexing an audio file into the vector store.
+ *
+ * The audio is transcribed via an STT provider, then the transcript
+ * is embedded and stored alongside the original audio reference.
+ *
+ * @example
+ * ```typescript
+ * const result = await indexer.indexAudio({
+ *   audio: fs.readFileSync('./recording.wav'),
+ *   metadata: { source: 'meeting', duration: 3600 },
+ *   language: 'en',
+ * });
+ * ```
+ */
+export interface AudioIndexOptions {
+    /**
+     * Audio data as a raw Buffer (WAV, MP3, OGG, etc.).
+     * The format must be supported by the configured STT provider.
+     */
+    audio: Buffer;
+    /**
+     * Optional metadata to attach to the indexed document.
+     * Stored alongside the embedding for filtering during search.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Vector store collection to index into.
+     * @default 'multimodal'
+     */
+    collection?: string;
+    /**
+     * BCP-47 language hint for the STT provider (e.g. 'en', 'es', 'ja').
+     * Improves transcription accuracy for non-English audio.
+     */
+    language?: string;
+}
+/**
+ * Options for indexing plain text into the multimodal vector store.
+ *
+ * This is primarily used by higher-level orchestrators like the
+ * {@link MultimodalMemoryBridge} when extracted text from PDFs or other
+ * rich content should land in the same multimodal retrieval pipeline.
+ */
+export interface TextIndexOptions {
+    /**
+     * Text to embed and store.
+     */
+    text: string;
+    /**
+     * Optional metadata to attach to the indexed document.
+     * Stored alongside the embedding for filtering during search.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Vector store collection to index into.
+     * @default 'multimodal'
+     */
+    collection?: string;
+}
+/**
+ * Result of indexing an image into the vector store.
+ *
+ * @see {@link ImageIndexOptions} for the input shape.
+ */
+export interface ImageIndexResult {
+    /** Unique document ID in the vector store. */
+    id: string;
+    /** Vision LLM-generated description of the image. */
+    description: string;
+}
+/**
+ * Result of indexing an audio file into the vector store.
+ *
+ * @see {@link AudioIndexOptions} for the input shape.
+ */
+export interface AudioIndexResult {
+    /** Unique document ID in the vector store. */
+    id: string;
+    /** STT-generated transcript of the audio. */
+    transcript: string;
+}
+/**
+ * Result of indexing plain text into the vector store.
+ */
+export interface TextIndexResult {
+    /** Unique document ID in the vector store. */
+    id: string;
+    /** Indexed text content after normalization. */
+    text: string;
+}
+/**
+ * Options for cross-modal search.
+ *
+ * @example
+ * ```typescript
+ * const results = await indexer.search('cats playing', {
+ *   topK: 10,
+ *   modalities: ['image', 'text'],
+ *   collection: 'user-content',
+ * });
+ * ```
+ */
+export interface MultimodalSearchOptions {
+    /**
+     * Maximum number of results to return.
+     * @default 5
+     */
+    topK?: number;
+    /**
+     * Filter results to specific modalities. If omitted or empty,
+     * all modalities are searched.
+     */
+    modalities?: ContentModality[];
+    /**
+     * Vector store collection to search in.
+     * @default 'multimodal'
+     */
+    collection?: string;
+    /**
+     * HyDE (Hypothetical Document Embedding) configuration for this search.
+     *
+     * When enabled, a hypothetical answer is generated from the query via LLM
+     * and embedded instead of the raw query. This produces embeddings that are
+     * semantically closer to stored document representations, improving recall
+     * for vague or exploratory queries.
+     *
+     * Requires a `HydeRetriever` to be set on the indexer via
+     * {@link MultimodalIndexer.setHydeRetriever}.
+     *
+     * @example
+     * ```typescript
+     * const results = await indexer.search('architecture diagram', {
+     *   hyde: { enabled: true },
+     * });
+     * ```
+     */
+    hyde?: {
+        /** Whether to use HyDE for this search. @default false */
+        enabled?: boolean;
+        /** Pre-generated hypothesis text (skips the LLM call). */
+        hypothesis?: string;
+    };
+}
+/**
+ * A single result from a multimodal search query.
+ *
+ * Extends the base vector store result with modality-specific fields
+ * so the caller knows what kind of content matched and can render
+ * it appropriately.
+ */
+export interface MultimodalSearchResult {
+    /** Unique document ID in the vector store. */
+    id: string;
+    /**
+     * The text content that was embedded and matched.
+     * For images: the vision LLM description.
+     * For audio: the STT transcript.
+     * For text: the original text chunk.
+     */
+    content: string;
+    /**
+     * Cosine similarity score between the query and this result.
+     * Higher is more relevant (typically 0.0 to 1.0).
+     */
+    score: number;
+    /**
+     * The content modality of this result.
+     * Indicates whether the match came from text, image description,
+     * or audio transcript.
+     */
+    modality: ContentModality;
+    /**
+     * Any metadata attached during indexing.
+     * May include source URLs, file names, timestamps, etc.
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Minimal interface for a vision LLM that can describe images.
+ *
+ * This is kept intentionally narrow to avoid coupling the multimodal
+ * indexer to a specific LLM provider. Any service that can take an
+ * image and return a text description satisfies this contract.
+ *
+ * @example
+ * ```typescript
+ * const visionProvider: IVisionProvider = {
+ *   describeImage: async (image) => {
+ *     const response = await openai.chat.completions.create({
+ *       model: 'gpt-4o',
+ *       messages: [{ role: 'user', content: [
+ *         { type: 'text', text: 'Describe this image in detail.' },
+ *         { type: 'image_url', image_url: { url: imageUrl } },
+ *       ]}],
+ *     });
+ *     return response.choices[0].message.content!;
+ *   },
+ * };
+ * ```
+ */
+export interface IVisionProvider {
+    /**
+     * Generate a text description of the provided image.
+     *
+     * @param image - Image as a URL string or base64 data URL.
+     * @returns A detailed text description of the image content.
+     */
+    describeImage(image: string): Promise<string>;
+}
+/**
+ * Minimal interface for a speech-to-text provider.
+ *
+ * This is kept intentionally narrow to avoid coupling the multimodal
+ * indexer to a specific STT service. Any service that can transcribe
+ * audio buffers satisfies this contract.
+ *
+ * @example
+ * ```typescript
+ * const sttProvider: ISpeechToTextProvider = {
+ *   transcribe: async (audio, language) => {
+ *     const response = await openai.audio.transcriptions.create({
+ *       model: 'whisper-1',
+ *       file: audio,
+ *       language,
+ *     });
+ *     return response.text;
+ *   },
+ * };
+ * ```
+ */
+export interface ISpeechToTextProvider {
+    /**
+     * Transcribe audio data to text.
+     *
+     * @param audio - Raw audio data as a Buffer.
+     * @param language - Optional BCP-47 language code hint.
+     * @returns The transcribed text.
+     */
+    transcribe(audio: Buffer, language?: string): Promise<string>;
+}
+/**
+ * Configuration for the {@link MultimodalIndexer}.
+ *
+ * @example
+ * ```typescript
+ * const config: MultimodalIndexerConfig = {
+ *   defaultCollection: 'knowledge-base',
+ *   imageDescriptionPrompt: 'Describe this image for use in a search index.',
+ * };
+ * ```
+ */
+export interface MultimodalIndexerConfig {
+    /**
+     * Default vector store collection name for indexed content.
+     * @default 'multimodal'
+     */
+    defaultCollection?: string;
+    /**
+     * Custom prompt template for the vision LLM when describing images.
+     * If omitted, a sensible default prompt is used.
+     */
+    imageDescriptionPrompt?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/cognition/rag/multimodal/types.js.map

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

package/dist/cognition/rag/raptor/RaptorTree.d.ts.map

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

package/dist/cognition/rag/raptor/RaptorTree.js.map

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

package/dist/cognition/rag/raptor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cognition/rag/raptor/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC"}

package/dist/cognition/rag/raptor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cognition/rag/raptor/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,UAAU,GAKX,MAAM,iBAAiB,CAAC"}

package/dist/cognition/rag/reranking/IRerankerService.d.ts.map

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

package/dist/cognition/rag/reranking/IRerankerService.js.map

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

package/dist/cognition/rag/reranking/RerankerService.d.ts

@@ -0,0 +1,118 @@
+/**
+ * @fileoverview Provider-agnostic reranker service that orchestrates cross-encoder
+ * reranking operations. Supports multiple backend providers (local models, cloud APIs).
+ *
+ * @module backend/agentos/rag/reranking/RerankerService
+ */
+import type { ILogger } from '../../../logging/ILogger';
+import type { RagRetrievedChunk } from '../IRetrievalAugmentor';
+import type { IRerankerProvider, RerankerInput, RerankerOutput, RerankerRequestConfig, RerankerServiceConfig, RerankChainStage, RerankerProviderConfig } from './IRerankerService';
+/**
+ * Configuration for the RerankerService constructor.
+ */
+export interface RerankerServiceOptions {
+    /** Service configuration */
+    config: RerankerServiceConfig;
+    /** Optional logger instance */
+    logger?: ILogger;
+}
+/**
+ * Provider-agnostic reranker service.
+ *
+ * Orchestrates cross-encoder reranking across multiple providers (local models,
+ * cloud APIs) with a unified interface. Handles provider selection, request
+ * routing, and result mapping back to RAG chunk format.
+ *
+ * @example
+ * ```typescript
+ * const service = new RerankerService({
+ *   config: {
+ *     providers: [
+ *       { providerId: 'local', defaultModelId: 'cross-encoder/ms-marco-MiniLM-L-6-v2' },
+ *       { providerId: 'cohere', apiKey: process.env.COHERE_API_KEY }
+ *     ],
+ *     defaultProviderId: 'local'
+ *   }
+ * });
+ *
+ * // Register provider implementations
+ * service.registerProvider(new LocalCrossEncoderReranker(...));
+ * service.registerProvider(new CohereReranker(...));
+ *
+ * // Rerank chunks
+ * const reranked = await service.rerankChunks(query, chunks, { providerId: 'local' });
+ * ```
+ */
+export declare class RerankerService {
+    private readonly providers;
+    private readonly providerConfigs;
+    private readonly config;
+    private readonly logger?;
+    constructor(options: RerankerServiceOptions);
+    /**
+     * Register a reranker provider implementation.
+     *
+     * @param provider - Provider instance to register
+     */
+    registerProvider(provider: IRerankerProvider): void;
+    /**
+     * Get a registered provider by ID.
+     *
+     * @param providerId - Provider identifier
+     * @returns Provider instance or undefined if not found
+     */
+    getProvider(providerId: string): IRerankerProvider | undefined;
+    /**
+     * Get configuration for a provider.
+     *
+     * @param providerId - Provider identifier
+     * @returns Provider configuration or undefined if not found
+     */
+    getProviderConfig(providerId: string): RerankerProviderConfig | undefined;
+    /**
+     * List all registered provider IDs.
+     *
+     * @returns Array of provider identifiers
+     */
+    listProviders(): string[];
+    /**
+     * Check if a provider is available.
+     *
+     * @param providerId - Provider identifier
+     * @returns True if provider is registered and available
+     */
+    isProviderAvailable(providerId: string): Promise<boolean>;
+    /**
+     * Rerank documents using the specified or default provider.
+     *
+     * @param input - Query and documents to rerank
+     * @param config - Request configuration (optional, uses defaults if not provided)
+     * @returns Reranked documents with relevance scores
+     * @throws Error if provider not found or reranking fails
+     */
+    rerank(input: RerankerInput, config?: Partial<RerankerRequestConfig>): Promise<RerankerOutput>;
+    /**
+     * Rerank RAG chunks and return updated chunks with new relevance scores.
+     *
+     * This is the main method used by RetrievalAugmentor. It accepts RagRetrievedChunk[],
+     * performs reranking, and returns the same type with updated scores.
+     *
+     * @param query - User query
+     * @param chunks - Retrieved chunks to rerank
+     * @param config - Request configuration
+     * @returns Reranked chunks sorted by relevance
+     */
+    rerankChunks(query: string, chunks: RagRetrievedChunk[], config?: Partial<RerankerRequestConfig>): Promise<RagRetrievedChunk[]>;
+    /**
+     * Run chunks through a multi-stage reranker pipeline.
+     * Each stage's output feeds into the next, narrowing the result set.
+     * Unavailable providers are silently skipped.
+     *
+     * @param query - The search query.
+     * @param chunks - Input chunks to rerank.
+     * @param chain - Ordered array of reranking stages.
+     * @returns Reranked chunks after all stages.
+     */
+    rerankChain(query: string, chunks: RagRetrievedChunk[], chain: RerankChainStage[]): Promise<RagRetrievedChunk[]>;
+}
+//# sourceMappingURL=RerankerService.d.ts.map

package/dist/cognition/rag/reranking/RerankerService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RerankerService.d.ts","sourceRoot":"","sources":["../../../../src/cognition/rag/reranking/RerankerService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,4BAA4B;IAC5B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,+BAA+B;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6C;IACvE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkD;IAClF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAU;gBAEtB,OAAO,EAAE,sBAAsB;IAU3C;;;;OAIG;IACI,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAK1D;;;;;OAKG;IACI,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIrE;;;;;OAKG;IACI,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAIhF;;;;OAIG;IACI,aAAa,IAAI,MAAM,EAAE;IAIhC;;;;;OAKG;IACU,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMtE;;;;;;;OAOG;IACU,MAAM,CACjB,KAAK,EAAE,aAAa,EACpB,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACtC,OAAO,CAAC,cAAc,CAAC;IA2D1B;;;;;;;;;;OAUG;IACU,YAAY,CACvB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,iBAAiB,EAAE,EAC3B,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACtC,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA6C/B;;;;;;;;;OASG;IACU,WAAW,CACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,iBAAiB,EAAE,EAC3B,KAAK,EAAE,gBAAgB,EAAE,GACxB,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAyChC"}

package/dist/cognition/rag/reranking/RerankerService.js.map

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

package/dist/cognition/rag/reranking/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Cross-encoder reranking module for the AgentOS RAG pipeline.
+ *
+ * This module provides pluggable reranking capabilities using cross-encoder models
+ * to improve retrieval relevance. Supports both local models (via transformers.js)
+ * and cloud APIs (Cohere).
+ *
+ * @module @framers/agentos/rag/reranking
+ *
+ * @example Basic usage with local model
+ * ```typescript
+ * import { RerankerService, LocalCrossEncoderReranker } from '@framers/agentos/rag/reranking';
+ *
+ * const service = new RerankerService({
+ *   config: {
+ *     providers: [{ providerId: 'local' }],
+ *     defaultProviderId: 'local'
+ *   }
+ * });
+ *
+ * service.registerProvider(new LocalCrossEncoderReranker({
+ *   providerId: 'local',
+ *   defaultModelId: 'cross-encoder/ms-marco-MiniLM-L-6-v2'
+ * }));
+ *
+ * const reranked = await service.rerankChunks(query, chunks);
+ * ```
+ *
+ * @example Using Cohere API
+ * ```typescript
+ * import { RerankerService, CohereReranker } from '@framers/agentos/rag/reranking';
+ *
+ * const service = new RerankerService({
+ *   config: {
+ *     providers: [{ providerId: 'cohere', apiKey: process.env.COHERE_API_KEY }],
+ *     defaultProviderId: 'cohere'
+ *   }
+ * });
+ *
+ * service.registerProvider(new CohereReranker({
+ *   providerId: 'cohere',
+ *   apiKey: process.env.COHERE_API_KEY!
+ * }));
+ *
+ * const reranked = await service.rerankChunks(query, chunks, {
+ *   modelId: 'rerank-v3.5',
+ *   topN: 5
+ * });
+ * ```
+ */
+export type { IRerankerProvider, RerankerInput, RerankerOutput, RerankerDocument, RerankedDocument, RerankerRequestConfig, RerankerProviderConfig, RerankerServiceConfig, RerankerDiagnostics, } from './IRerankerService';
+export { RerankerService, type RerankerServiceOptions } from './RerankerService';
+export { CohereReranker, type CohereRerankerConfig, COHERE_RERANKER_MODELS, type CohereRerankerModel, } from './providers/CohereReranker';
+export { LocalCrossEncoderReranker, type LocalCrossEncoderConfig, LOCAL_RERANKER_MODELS, type LocalRerankerModel, } from './providers/LocalCrossEncoderReranker';
+export { LlmJudgeReranker, type LlmJudgeRerankerConfig, } from './providers/LlmJudgeReranker';
+export type { RerankChainStage } from './IRerankerService';
+//# sourceMappingURL=index.d.ts.map

package/dist/cognition/rag/reranking/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cognition/rag/reranking/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAGH,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGjF,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,sBAAsB,EACtB,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,yBAAyB,EACzB,KAAK,uBAAuB,EAC5B,qBAAqB,EACrB,KAAK,kBAAkB,GACxB,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,GAC5B,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/cognition/rag/reranking/index.js

@@ -0,0 +1,57 @@
+/**
+ * Cross-encoder reranking module for the AgentOS RAG pipeline.
+ *
+ * This module provides pluggable reranking capabilities using cross-encoder models
+ * to improve retrieval relevance. Supports both local models (via transformers.js)
+ * and cloud APIs (Cohere).
+ *
+ * @module @framers/agentos/rag/reranking
+ *
+ * @example Basic usage with local model
+ * ```typescript
+ * import { RerankerService, LocalCrossEncoderReranker } from '@framers/agentos/rag/reranking';
+ *
+ * const service = new RerankerService({
+ *   config: {
+ *     providers: [{ providerId: 'local' }],
+ *     defaultProviderId: 'local'
+ *   }
+ * });
+ *
+ * service.registerProvider(new LocalCrossEncoderReranker({
+ *   providerId: 'local',
+ *   defaultModelId: 'cross-encoder/ms-marco-MiniLM-L-6-v2'
+ * }));
+ *
+ * const reranked = await service.rerankChunks(query, chunks);
+ * ```
+ *
+ * @example Using Cohere API
+ * ```typescript
+ * import { RerankerService, CohereReranker } from '@framers/agentos/rag/reranking';
+ *
+ * const service = new RerankerService({
+ *   config: {
+ *     providers: [{ providerId: 'cohere', apiKey: process.env.COHERE_API_KEY }],
+ *     defaultProviderId: 'cohere'
+ *   }
+ * });
+ *
+ * service.registerProvider(new CohereReranker({
+ *   providerId: 'cohere',
+ *   apiKey: process.env.COHERE_API_KEY!
+ * }));
+ *
+ * const reranked = await service.rerankChunks(query, chunks, {
+ *   modelId: 'rerank-v3.5',
+ *   topN: 5
+ * });
+ * ```
+ */
+// Main service
+export { RerankerService } from './RerankerService.js';
+// Providers
+export { CohereReranker, COHERE_RERANKER_MODELS, } from './providers/CohereReranker.js';
+export { LocalCrossEncoderReranker, LOCAL_RERANKER_MODELS, } from './providers/LocalCrossEncoderReranker.js';
+export { LlmJudgeReranker, } from './providers/LlmJudgeReranker.js';
+//# sourceMappingURL=index.js.map

package/dist/cognition/rag/reranking/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cognition/rag/reranking/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAeH,eAAe;AACf,OAAO,EAAE,eAAe,EAA+B,MAAM,mBAAmB,CAAC;AAEjF,YAAY;AACZ,OAAO,EACL,cAAc,EAEd,sBAAsB,GAEvB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,yBAAyB,EAEzB,qBAAqB,GAEtB,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EACL,gBAAgB,GAEjB,MAAM,8BAA8B,CAAC"}

package/dist/cognition/rag/reranking/providers/CohereReranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CohereReranker.d.ts","sourceRoot":"","sources":["../../../../../src/cognition/rag/reranking/providers/CohereReranker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,sBAAsB;IAClE,UAAU,EAAE,QAAQ,CAAC;IACrB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAiBD;;GAEG;AACH,eAAO,MAAM,sBAAsB,uKAUzB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,cAAe,YAAW,iBAAiB;IACtD,SAAgB,UAAU,EAAG,QAAQ,CAAU;IAE/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,MAAM,EAAE,oBAAoB;IAQxC;;OAEG;IACU,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAS5C;;OAEG;IACI,kBAAkB,IAAI,MAAM,EAAE;IAIrC;;OAEG;IACU,MAAM,CACjB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,cAAc,CAAC;CAiF3B"}