@framers/agentos 0.1.113 → 0.1.114

package/dist/query-router/types.d.ts

@@ -0,0 +1,508 @@
+/**
+ * @fileoverview Core types for the QueryRouter module.
+ * @module @framers/agentos/query-router/types
+ *
+ * Defines all interfaces, configuration, event types, and data structures
+ * used by the intelligent query routing pipeline. The QueryRouter classifies
+ * incoming queries by complexity tier, retrieves relevant context from vector
+ * stores and knowledge graphs, and generates grounded answers with citations.
+ *
+ * Key concepts:
+ * - QueryTier: Four-tier complexity classification (0 = trivial, 3 = research)
+ * - ClassificationResult: Output of the query classifier with confidence scoring
+ * - RetrievalResult: Aggregated chunks from vector, graph, and research sources
+ * - QueryResult: Final answer with citations, timing, and tier metadata
+ * - QueryRouterConfig: Public constructor config with sensible defaults
+ * - Event system: Discriminated union of lifecycle events for observability
+ */
+/**
+ * Complexity tier assigned to an incoming query.
+ *
+ * - `0` — **Trivial**: Answered from conversation context or general knowledge
+ *   (e.g., "What is TypeScript?"). No retrieval needed.
+ * - `1` — **Simple lookup**: Single-source retrieval sufficient
+ *   (e.g., "What port does the API run on?"). Vector search only.
+ * - `2` — **Multi-source**: Requires combining information from multiple chunks
+ *   or graph traversal (e.g., "How does auth flow from frontend to backend?").
+ * - `3` — **Research**: Deep investigation across the entire corpus, possibly
+ *   with iterative refinement (e.g., "Compare all caching strategies used in
+ *   this codebase and recommend improvements.").
+ */
+export type QueryTier = 0 | 1 | 2 | 3;
+/**
+ * Result of classifying a user query into a complexity tier.
+ * Produced by the {@link QueryClassifier}.
+ */
+export interface ClassificationResult {
+    /**
+     * The assigned complexity tier.
+     * @see QueryTier
+     */
+    tier: QueryTier;
+    /**
+     * Confidence score for the classification (0 to 1).
+     * A score below the configured threshold may trigger fallback behaviour.
+     */
+    confidence: number;
+    /**
+     * Human-readable reasoning explaining why this tier was chosen.
+     * Useful for debugging and audit trails.
+     */
+    reasoning: string;
+    /**
+     * Whether the agent's internal knowledge is likely sufficient to answer
+     * without any retrieval. When `true` and tier is 0, the router may skip
+     * retrieval entirely.
+     */
+    internalKnowledgeSufficient: boolean;
+    /**
+     * Suggested source types to consult for this query.
+     * @example ['vector', 'graph']
+     */
+    suggestedSources: Array<'vector' | 'graph' | 'research'>;
+    /**
+     * Tool names the classifier believes are needed to answer this query.
+     * Empty array if no tools are required.
+     */
+    toolsNeeded: string[];
+}
+/**
+ * A single chunk of content retrieved during the retrieval phase.
+ */
+export interface RetrievedChunk {
+    /** Unique identifier for the chunk (typically from the vector store). */
+    id: string;
+    /** The text content of the chunk. */
+    content: string;
+    /** Section heading or title the chunk belongs to, if available. */
+    heading: string;
+    /** File path or document source path this chunk was extracted from. */
+    sourcePath: string;
+    /**
+     * Relevance score (0 to 1) indicating how well this chunk matches
+     * the query. Higher is better.
+     */
+    relevanceScore: number;
+    /**
+     * Which retrieval method produced this chunk.
+     * - `'vector'` — Dense vector similarity search
+     * - `'graph'` — Knowledge graph traversal (GraphRAG)
+     * - `'research'` — Iterative deep research synthesis
+     */
+    matchType: 'vector' | 'graph' | 'research';
+}
+/**
+ * A citation referencing a source used in generating the final answer.
+ */
+export interface SourceCitation {
+    /** File path or document path of the cited source. */
+    path: string;
+    /** Section heading within the source, if applicable. */
+    heading: string;
+    /**
+     * Relevance score of the cited source (0 to 1).
+     * Inherited from the highest-scoring chunk from this source.
+     */
+    relevanceScore: number;
+    /**
+     * Which retrieval method produced the cited source.
+     * @see RetrievedChunk.matchType
+     */
+    matchType: 'vector' | 'graph' | 'research';
+}
+/**
+ * Aggregated result of the retrieval phase across all active retrieval
+ * strategies (vector search, graph traversal, deep research).
+ */
+export interface RetrievalResult {
+    /** Retrieved content chunks, sorted by relevance (highest first). */
+    chunks: RetrievedChunk[];
+    /**
+     * Entities discovered via knowledge graph traversal.
+     * Present only when graph retrieval was used (tier >= 2).
+     */
+    graphEntities?: Array<{
+        name: string;
+        type: string;
+        description: string;
+    }>;
+    /**
+     * Synthesized narrative from the deep research phase.
+     * Present only when research retrieval was used (tier 3).
+     */
+    researchSynthesis?: string;
+    /** Wall-clock duration of the retrieval phase in milliseconds. */
+    durationMs: number;
+}
+/**
+ * A single message in the conversation history.
+ * Used for providing conversational context to the classifier and generator.
+ */
+export interface ConversationMessage {
+    /** The role of the message author. */
+    role: 'user' | 'assistant';
+    /** The text content of the message. */
+    content: string;
+}
+/**
+ * Final result returned by the QueryRouter after classification, retrieval,
+ * and answer generation.
+ */
+export interface QueryResult {
+    /** The generated answer text, grounded in retrieved sources. */
+    answer: string;
+    /** The classification result that determined routing behaviour. */
+    classification: ClassificationResult;
+    /** Citations for the sources used in generating the answer. */
+    sources: SourceCitation[];
+    /** Total wall-clock duration of the entire query pipeline in milliseconds. */
+    durationMs: number;
+    /**
+     * Which tiers were actually exercised during this query.
+     * @example [0] for trivial, [1, 2] for multi-source with fallback
+     */
+    tiersUsed: QueryTier[];
+    /**
+     * Names of fallback strategies that were activated during this query.
+     * Empty array if no fallbacks were needed.
+     * @example ['keyword-fallback', 'tier-escalation']
+     */
+    fallbacksUsed: string[];
+}
+/**
+ * Public constructor configuration for the QueryRouter pipeline.
+ *
+ * `knowledgeCorpus` is required. All other fields are optional and default to
+ * the values in {@link DEFAULT_QUERY_ROUTER_CONFIG}.
+ */
+export interface QueryRouterConfig {
+    /**
+     * Directories containing `.md` / `.mdx` files to ingest as the knowledge
+     * corpus.
+     */
+    knowledgeCorpus: string[];
+    /**
+     * Minimum confidence threshold for accepting a classification result.
+     * If confidence falls below this, the router may escalate to a higher tier.
+     * @default 0.7
+     */
+    confidenceThreshold?: number;
+    /** LLM model for the classifier. @default 'gpt-4o-mini' */
+    classifierModel?: string;
+    /** LLM provider for the classifier. @default 'openai' */
+    classifierProvider?: string;
+    /** Maximum tier the classifier may assign. @default 3 */
+    maxTier?: QueryTier;
+    /** Embedding provider name. @default 'openai' */
+    embeddingProvider?: string;
+    /** Embedding model identifier. @default 'text-embedding-3-small' */
+    embeddingModel?: string;
+    /** LLM model for T0/T1 generation. @default 'gpt-4o-mini' */
+    generationModel?: string;
+    /** LLM model for T2/T3 generation (deep). @default 'gpt-4o' */
+    generationModelDeep?: string;
+    /** LLM provider for generation. @default 'openai' */
+    generationProvider?: string;
+    /**
+     * Whether to enable GraphRAG-based retrieval for tier >= 2 queries.
+     * Requires a configured GraphRAG engine.
+     * @default true
+     */
+    graphEnabled?: boolean;
+    /**
+     * Whether to enable deep research mode for tier 3 queries.
+     * Research mode performs iterative multi-pass retrieval and synthesis.
+     * @default true
+     */
+    deepResearchEnabled?: boolean;
+    /**
+     * Number of recent conversation messages to include as context
+     * for classification and generation.
+     * @default 5
+     */
+    conversationWindowSize?: number;
+    /**
+     * Maximum estimated tokens to allocate for documentation context.
+     * @default 4000
+     */
+    maxContextTokens?: number;
+    /**
+     * Whether to cache query results.
+     * @default true
+     */
+    cacheResults?: boolean;
+    /**
+     * Optional tool/capability names exposed to the classifier prompt so it can
+     * reason about what the runtime can actually do.
+     * @default []
+     */
+    availableTools?: string[];
+    /**
+     * Hook called after classification completes.
+     * Receives the ClassificationResult for consumer integration.
+     */
+    onClassification?: (result: ClassificationResult) => void;
+    /**
+     * Hook called after retrieval completes.
+     * Receives the RetrievalResult for consumer integration.
+     */
+    onRetrieval?: (result: RetrievalResult) => void;
+    /** Optional API key override for LLM calls. */
+    apiKey?: string;
+    /** Optional base URL override for LLM providers. */
+    baseUrl?: string;
+}
+/**
+ * Default configuration values for the QueryRouter.
+ * @see QueryRouterConfig
+ */
+export declare const DEFAULT_QUERY_ROUTER_CONFIG: {
+    confidenceThreshold: number;
+    classifierModel: string;
+    classifierProvider: string;
+    maxTier: QueryTier;
+    embeddingProvider: string;
+    embeddingModel: string;
+    generationModel: string;
+    generationModelDeep: string;
+    generationProvider: string;
+    graphEnabled: true;
+    deepResearchEnabled: boolean;
+    conversationWindowSize: number;
+    maxContextTokens: number;
+    cacheResults: true;
+    availableTools: string[];
+};
+/**
+ * Emitted when query classification begins.
+ */
+export interface ClassifyStartEvent {
+    type: 'classify:start';
+    /** The raw user query being classified. */
+    query: string;
+    /** Timestamp when classification started. */
+    timestamp: number;
+}
+/**
+ * Emitted when query classification completes successfully.
+ */
+export interface ClassifyCompleteEvent {
+    type: 'classify:complete';
+    /** The classification result. */
+    result: ClassificationResult;
+    /** Duration of classification in milliseconds. */
+    durationMs: number;
+    /** Timestamp when classification completed. */
+    timestamp: number;
+}
+/**
+ * Emitted when query classification fails.
+ */
+export interface ClassifyErrorEvent {
+    type: 'classify:error';
+    /** The error that caused classification to fail. */
+    error: Error;
+    /** Timestamp when the error occurred. */
+    timestamp: number;
+}
+/**
+ * Emitted when the retrieval phase begins.
+ */
+export interface RetrieveStartEvent {
+    type: 'retrieve:start';
+    /** The assigned tier driving retrieval strategy. */
+    tier: QueryTier;
+    /** Timestamp when retrieval started. */
+    timestamp: number;
+}
+/**
+ * Emitted when vector search results are available.
+ */
+export interface RetrieveVectorEvent {
+    type: 'retrieve:vector';
+    /** Number of chunks returned by vector search. */
+    chunkCount: number;
+    /** Duration of vector retrieval in milliseconds. */
+    durationMs: number;
+    /** Timestamp of the event. */
+    timestamp: number;
+}
+/**
+ * Emitted when graph traversal results are available.
+ */
+export interface RetrieveGraphEvent {
+    type: 'retrieve:graph';
+    /** Number of entities discovered via graph traversal. */
+    entityCount: number;
+    /** Duration of graph retrieval in milliseconds. */
+    durationMs: number;
+    /** Timestamp of the event. */
+    timestamp: number;
+}
+/**
+ * Emitted when reranking of retrieved chunks completes.
+ */
+export interface RetrieveRerankEvent {
+    type: 'retrieve:rerank';
+    /** Number of chunks before reranking. */
+    inputCount: number;
+    /** Number of chunks after reranking (may be fewer due to threshold filtering). */
+    outputCount: number;
+    /** Duration of reranking in milliseconds. */
+    durationMs: number;
+    /** Timestamp of the event. */
+    timestamp: number;
+}
+/**
+ * Emitted when the entire retrieval phase completes.
+ */
+export interface RetrieveCompleteEvent {
+    type: 'retrieve:complete';
+    /** The aggregated retrieval result. */
+    result: RetrievalResult;
+    /** Timestamp when retrieval completed. */
+    timestamp: number;
+}
+/**
+ * Emitted when a retrieval fallback strategy is activated.
+ */
+export interface RetrieveFallbackEvent {
+    type: 'retrieve:fallback';
+    /** Name of the fallback strategy activated (e.g., 'keyword-fallback'). */
+    strategy: string;
+    /** Reason the fallback was triggered. */
+    reason: string;
+    /** Timestamp of the event. */
+    timestamp: number;
+}
+/**
+ * Emitted when deep research begins (tier 3 only).
+ */
+export interface ResearchStartEvent {
+    type: 'research:start';
+    /** The original query being researched. */
+    query: string;
+    /** Maximum number of research iterations configured. */
+    maxIterations: number;
+    /** Timestamp when research started. */
+    timestamp: number;
+}
+/**
+ * Emitted after each iteration of the research loop.
+ */
+export interface ResearchPhaseEvent {
+    type: 'research:phase';
+    /** Current iteration number (1-based). */
+    iteration: number;
+    /** Total configured iterations. */
+    totalIterations: number;
+    /** Number of new chunks discovered in this iteration. */
+    newChunksFound: number;
+    /** Timestamp of the event. */
+    timestamp: number;
+}
+/**
+ * Emitted when deep research completes.
+ */
+export interface ResearchCompleteEvent {
+    type: 'research:complete';
+    /** Total number of research iterations performed. */
+    iterationsUsed: number;
+    /** Total chunks gathered across all iterations. */
+    totalChunks: number;
+    /** Duration of the research phase in milliseconds. */
+    durationMs: number;
+    /** Timestamp when research completed. */
+    timestamp: number;
+}
+/**
+ * Emitted when answer generation begins.
+ */
+export interface GenerateStartEvent {
+    type: 'generate:start';
+    /** Number of context chunks provided to the generator. */
+    contextChunkCount: number;
+    /** Timestamp when generation started. */
+    timestamp: number;
+}
+/**
+ * Emitted when answer generation completes.
+ */
+export interface GenerateCompleteEvent {
+    type: 'generate:complete';
+    /** Length of the generated answer in characters. */
+    answerLength: number;
+    /** Number of source citations in the answer. */
+    citationCount: number;
+    /** Duration of generation in milliseconds. */
+    durationMs: number;
+    /** Timestamp when generation completed. */
+    timestamp: number;
+}
+/**
+ * Emitted when the entire query routing pipeline completes.
+ */
+export interface RouteCompleteEvent {
+    type: 'route:complete';
+    /** The final query result. */
+    result: QueryResult;
+    /** Total duration of the entire pipeline in milliseconds. */
+    durationMs: number;
+    /** Timestamp when routing completed. */
+    timestamp: number;
+}
+/**
+ * Discriminated union of all QueryRouter lifecycle events.
+ * The `type` field serves as the discriminant for exhaustive matching.
+ *
+ * @example
+ * ```typescript
+ * function handleEvent(event: QueryRouterEventUnion) {
+ *   switch (event.type) {
+ *     case 'classify:start':
+ *       console.log(`Classifying: ${event.query}`);
+ *       break;
+ *     case 'retrieve:vector':
+ *       console.log(`Vector search returned ${event.chunkCount} chunks`);
+ *       break;
+ *     case 'route:complete':
+ *       console.log(`Done in ${event.durationMs}ms`);
+ *       break;
+ *   }
+ * }
+ * ```
+ */
+export type QueryRouterEventUnion = ClassifyStartEvent | ClassifyCompleteEvent | ClassifyErrorEvent | RetrieveStartEvent | RetrieveVectorEvent | RetrieveGraphEvent | RetrieveRerankEvent | RetrieveCompleteEvent | RetrieveFallbackEvent | ResearchStartEvent | ResearchPhaseEvent | ResearchCompleteEvent | GenerateStartEvent | GenerateCompleteEvent | RouteCompleteEvent;
+/**
+ * A chunk of corpus content with optional pre-computed embedding.
+ * Used during corpus ingestion into the vector store.
+ */
+export interface CorpusChunk {
+    /** Unique identifier for the chunk. */
+    id: string;
+    /** The text content of the chunk. */
+    content: string;
+    /** Section heading or title the chunk belongs to. */
+    heading: string;
+    /** File path or document source path this chunk was extracted from. */
+    sourcePath: string;
+    /**
+     * Pre-computed embedding vector. When present, the ingestion pipeline
+     * can skip embedding generation for this chunk.
+     */
+    embedding?: number[];
+}
+/**
+ * A topic extracted from a query or document for routing and filtering.
+ * Used by the {@link TopicExtractor} to guide retrieval strategy.
+ */
+export interface TopicEntry {
+    /** The topic name or phrase (e.g., "authentication", "database migrations"). */
+    name: string;
+    /**
+     * Where this topic was derived from.
+     * @example 'query', 'document', 'graph-entity'
+     */
+    source: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/query-router/types.d.ts.map

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

package/dist/query-router/types.js

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Core types for the QueryRouter module.
+ * @module @framers/agentos/query-router/types
+ *
+ * Defines all interfaces, configuration, event types, and data structures
+ * used by the intelligent query routing pipeline. The QueryRouter classifies
+ * incoming queries by complexity tier, retrieves relevant context from vector
+ * stores and knowledge graphs, and generates grounded answers with citations.
+ *
+ * Key concepts:
+ * - QueryTier: Four-tier complexity classification (0 = trivial, 3 = research)
+ * - ClassificationResult: Output of the query classifier with confidence scoring
+ * - RetrievalResult: Aggregated chunks from vector, graph, and research sources
+ * - QueryResult: Final answer with citations, timing, and tier metadata
+ * - QueryRouterConfig: Public constructor config with sensible defaults
+ * - Event system: Discriminated union of lifecycle events for observability
+ */
+/**
+ * Default configuration values for the QueryRouter.
+ * @see QueryRouterConfig
+ */
+export const DEFAULT_QUERY_ROUTER_CONFIG = {
+    confidenceThreshold: 0.7,
+    classifierModel: 'gpt-4o-mini',
+    classifierProvider: 'openai',
+    maxTier: 3,
+    embeddingProvider: 'openai',
+    embeddingModel: 'text-embedding-3-small',
+    generationModel: 'gpt-4o-mini',
+    generationModelDeep: 'gpt-4o',
+    generationProvider: 'openai',
+    graphEnabled: true,
+    deepResearchEnabled: Boolean(process.env.SERPER_API_KEY),
+    conversationWindowSize: 5,
+    maxContextTokens: 4000,
+    cacheResults: true,
+    availableTools: [],
+};
+//# sourceMappingURL=types.js.map

package/dist/query-router/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/query-router/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAsTH;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,mBAAmB,EAAE,GAAG;IACxB,eAAe,EAAE,aAAa;IAC9B,kBAAkB,EAAE,QAAQ;IAC5B,OAAO,EAAE,CAAc;IACvB,iBAAiB,EAAE,QAAQ;IAC3B,cAAc,EAAE,wBAAwB;IACxC,eAAe,EAAE,aAAa;IAC9B,mBAAmB,EAAE,QAAQ;IAC7B,kBAAkB,EAAE,QAAQ;IAC5B,YAAY,EAAE,IAAI;IAClB,mBAAmB,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IACxD,sBAAsB,EAAE,CAAC;IACzB,gBAAgB,EAAE,IAAI;IACtB,YAAY,EAAE,IAAI;IAClB,cAAc,EAAE,EAAc;CAI/B,CAAC"}

package/dist/rag/index.d.ts

@@ -99,4 +99,9 @@ export { GraphRAGEngine } from './graphrag/index.js';
 export type { IGraphRAGEngine, GraphRAGConfig, GraphEntity, GraphRelationship, GraphCommunity, GraphRAGSearchOptions, GlobalSearchResult, LocalSearchResult, } from './graphrag/index.js';
 export type { RAGAuditTrail, RAGOperationEntry, RAGSourceAttribution, } from './audit/index.js';
 export { RAGAuditCollector, RAGOperationHandle, type RAGAuditCollectorOptions, } from './audit/index.js';
+export { MultimodalIndexer } from './multimodal/index.js';
+export { SpeechProviderAdapter } from './multimodal/index.js';
+export { LLMVisionAdapter, type LLMVisionAdapterConfig } from './multimodal/index.js';
+export { createMultimodalIndexerFromResolver, type MultimodalIndexerFromResolverOptions, } from './multimodal/index.js';
+export type { ContentModality, ImageIndexOptions, ImageIndexResult, AudioIndexOptions, AudioIndexResult, MultimodalSearchOptions, MultimodalSearchResult, IVisionProvider, ISpeechToTextProvider, MultimodalIndexerConfig, } from './multimodal/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rag/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AAMH,YAAY,EACV,YAAY,EACZ,yBAAyB,EACzB,cAAc,EACd,uBAAuB,EACvB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,uBAAuB,EACvB,cAAc,EACd,aAAa,EACb,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,mBAAmB,EACnB,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EACL,aAAa,EACb,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAE,KAAK,wBAAwB,EAAE,MAAM,uDAAuD,CAAC;AAC1H,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AAMvH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAM7B,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rag/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AAMH,YAAY,EACV,YAAY,EACZ,yBAAyB,EACzB,cAAc,EACd,uBAAuB,EACvB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,uBAAuB,EACvB,cAAc,EACd,aAAa,EACb,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,mBAAmB,EACnB,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EACL,aAAa,EACb,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAE,KAAK,wBAAwB,EAAE,MAAM,uDAAuD,CAAC;AAC1H,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AAMvH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAM7B,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EACL,mCAAmC,EACnC,KAAK,oCAAoC,GAC1C,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC"}

package/dist/rag/index.js

@@ -103,4 +103,11 @@ export { QdrantVectorStore } from './implementations/vector_stores/QdrantVectorS
 // ============================================================================
 export { GraphRAGEngine } from './graphrag/index.js';
 export { RAGAuditCollector, RAGOperationHandle, } from './audit/index.js';
+// ============================================================================
+// Multimodal Indexing (images, audio)
+// ============================================================================
+export { MultimodalIndexer } from './multimodal/index.js';
+export { SpeechProviderAdapter } from './multimodal/index.js';
+export { LLMVisionAdapter } from './multimodal/index.js';
+export { createMultimodalIndexerFromResolver, } from './multimodal/index.js';
 //# sourceMappingURL=index.js.map

package/dist/rag/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rag/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AA+CH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,mDAAmD;AACnD,OAAO,EACL,aAAa,EAIb,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,cAAc,EAA6B,MAAM,mDAAmD,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAiC,MAAM,uDAAuD,CAAC;AAC1H,OAAO,EAAE,iBAAiB,EAAgC,MAAM,sDAAsD,CAAC;AAEvH,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAsBrD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GAEnB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rag/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AA+CH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,mDAAmD;AACnD,OAAO,EACL,aAAa,EAIb,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,cAAc,EAA6B,MAAM,mDAAmD,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAiC,MAAM,uDAAuD,CAAC;AAC1H,OAAO,EAAE,iBAAiB,EAAgC,MAAM,sDAAsD,CAAC;AAEvH,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAsBrD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GAEnB,MAAM,kBAAkB,CAAC;AAE1B,+EAA+E;AAC/E,sCAAsC;AACtC,+EAA+E;AAE/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAA+B,MAAM,uBAAuB,CAAC;AACtF,OAAO,EACL,mCAAmC,GAEpC,MAAM,uBAAuB,CAAC"}

package/dist/rag/multimodal/LLMVisionAdapter.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @module rag/multimodal/LLMVisionAdapter
+ *
+ * Wraps a vision-capable LLM as an {@link IVisionProvider} for the
+ * multimodal RAG indexer.
+ *
+ * Unlike the full {@link VisionPipeline} which runs OCR, handwriting,
+ * document-AI tiers before escalating to cloud, this adapter goes
+ * straight to the LLM — making it the simplest path for teams that
+ * only need cloud vision and don't want the multi-tier pipeline.
+ *
+ * ## Relationship to LLMVisionProvider
+ *
+ * The `core/vision/providers/LLMVisionProvider` class fills the same
+ * role and already exists. This file re-exports it under the multimodal
+ * module namespace so consumers importing from `rag/multimodal` can
+ * access it without reaching into `core/vision/`. The underlying
+ * implementation is identical — this is a convenience re-export plus
+ * an alias type.
+ *
+ * @see {@link LLMVisionProvider} for the implementation.
+ * @see {@link PipelineVisionProvider} for the full-pipeline alternative.
+ * @see {@link IVisionProvider} for the interface contract.
+ *
+ * @example
+ * ```typescript
+ * import { LLMVisionAdapter } from './LLMVisionAdapter.js';
+ *
+ * const vision = new LLMVisionAdapter({
+ *   provider: 'openai',
+ *   model: 'gpt-4o',
+ *   prompt: 'Describe this image for a RAG search index.',
+ * });
+ *
+ * const indexer = new MultimodalIndexer({
+ *   embeddingManager,
+ *   vectorStore,
+ *   visionProvider: vision,
+ * });
+ * ```
+ */
+export { LLMVisionProvider as LLMVisionAdapter, type LLMVisionProviderConfig as LLMVisionAdapterConfig, } from '../../core/vision/providers/LLMVisionProvider.js';
+//# sourceMappingURL=LLMVisionAdapter.d.ts.map

package/dist/rag/multimodal/LLMVisionAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMVisionAdapter.d.ts","sourceRoot":"","sources":["../../../src/rag/multimodal/LLMVisionAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAKH,OAAO,EACL,iBAAiB,IAAI,gBAAgB,EACrC,KAAK,uBAAuB,IAAI,sBAAsB,GACvD,MAAM,kDAAkD,CAAC"}