rag-lite-ts 1.0.1 → 2.0.0

package/dist/index-manager.d.ts

@@ -1,4 +1,4 @@
-import type { EmbeddingResult } from './types.js';
+import type { EmbeddingResult } from './core/types.js';
 export interface IndexStats {
     totalVectors: number;
     modelVersion: string;
@@ -17,8 +17,9 @@ export declare class IndexManager {
     /**
      * Initialize the index manager and load existing index if available
      * @param skipModelCheck - Skip model compatibility check (used for rebuilds)
+     * @param forceRecreate - Force recreation of index (used for model changes)
      */
-    initialize(skipModelCheck?: boolean): Promise<void>;
+    initialize(skipModelCheck?: boolean, forceRecreate?: boolean): Promise<void>;
     /**
      * Check model compatibility between stored and current configuration
      * Requirements: 2.1, 2.2, 2.4, 5.1, 5.2, 5.3, 5.4

package/dist/index-manager.js

@@ -1,6 +1,6 @@
-import { VectorIndex } from './vector-index.js';
-import { openDatabase, getModelVersion, setModelVersion, getStoredModelInfo, setStoredModelInfo } from './db.js';
-import { config, getModelDefaults } from './config.js';
+import { VectorIndex } from './core/vector-index.js';
+import { openDatabase, getModelVersion, setModelVersion, getStoredModelInfo, setStoredModelInfo } from './core/db.js';
+import { config, getModelDefaults } from './core/config.js';
 export class IndexManager {
     modelName;
     vectorIndex;
@@ -25,8 +25,9 @@ export class IndexManager {
     /**
      * Initialize the index manager and load existing index if available
      * @param skipModelCheck - Skip model compatibility check (used for rebuilds)
+     * @param forceRecreate - Force recreation of index (used for model changes)
      */
-    async initialize(skipModelCheck = false) {
+    async initialize(skipModelCheck = false, forceRecreate = false) {
         if (this.isInitialized) {
             return;
         }
@@ -35,17 +36,18 @@ export class IndexManager {
             this.db = await openDatabase(this.dbPath);
             // Check model compatibility BEFORE trying to load the vector index
             // This prevents WebAssembly exceptions when dimensions don't match
-            if (!skipModelCheck) {
+            if (!skipModelCheck && !forceRecreate) {
                 await this.checkModelCompatibility();
             }
-            if (this.vectorIndex.indexExists()) {
-                console.log('Loading existing vector index...');
-                await this.vectorIndex.loadIndex();
-            }
-            else {
+            if (forceRecreate || !this.vectorIndex.indexExists()) {
                 console.log('Creating new vector index...');
                 await this.vectorIndex.initialize();
             }
+            else {
+                // Only try to load existing index if not forcing recreation
+                console.log('Loading existing vector index...');
+                await this.vectorIndex.loadIndex();
+            }
             // Always populate the embedding ID mapping from existing database entries
             // This is needed both for new and existing indexes
             const existingChunks = await this.db.all('SELECT embedding_id FROM chunks ORDER BY id');
@@ -383,7 +385,7 @@ export class IndexManager {
             throw new Error('Database not initialized');
         }
         try {
-            const rows = await this.db.all('SELECT embedding_id, text, document_id FROM chunks ORDER BY id');
+            const rows = await this.db.all('SELECT embedding_id, content as text, document_id FROM chunks ORDER BY id');
             return rows.map(row => ({
                 embedding_id: row.embedding_id,
                 text: row.text,

package/dist/index.d.ts

@@ -1,13 +1,77 @@
+/**
+ * rag-lite-ts - Clean Architecture with Factory Pattern
+ *
+ * Quick Start (Recommended):
+ * ```typescript
+ * import { SearchFactory, IngestionFactory } from 'rag-lite-ts';
+ *
+ * // Simple search - just works!
+ * const search = await SearchFactory.create('./index.bin', './db.sqlite');
+ * const results = await search.search('your query');
+ *
+ * // Simple ingestion - just works!
+ * const ingestion = await IngestionFactory.create('./db.sqlite', './index.bin');
+ * await ingestion.ingestDirectory('./documents');
+ * ```
+ *
+ * With Configuration:
+ * ```typescript
+ * const search = await SearchFactory.create('./index.bin', './db.sqlite', {
+ *   embeddingModel: 'Xenova/all-mpnet-base-v2',
+ *   enableReranking: true
+ * });
+ * ```
+ *
+ * Complete RAG System:
+ * ```typescript
+ * import { RAGFactory } from 'rag-lite-ts';
+ *
+ * const { searchEngine, ingestionPipeline } = await RAGFactory.createBoth(
+ *   './index.bin',
+ *   './db.sqlite'
+ * );
+ * ```
+ *
+ * Advanced Usage (Direct Dependency Injection):
+ * ```typescript
+ * import { CoreSearchEngine, createTextEmbedFunction } from 'rag-lite-ts';
+ *
+ * const embedFn = await createTextEmbedFunction();
+ * const search = new CoreSearchEngine(embedFn, indexManager, db);
+ * ```
+ */
+export { TextSearchFactory, TextIngestionFactory, TextRAGFactory, TextFactoryHelpers } from './factories/index.js';
+export { TextSearchFactory as SearchFactory, TextIngestionFactory as IngestionFactory, TextRAGFactory as RAGFactory } from './factories/index.js';
+export type { TextSearchOptions, TextIngestionOptions } from './factories/index.js';
+export type { TextSearchOptions as SearchEngineOptions, TextIngestionOptions as IngestionPipelineOptions } from './factories/index.js';
+export { SearchEngine as CoreSearchEngine } from './core/search.js';
+export { IngestionPipeline as CoreIngestionPipeline } from './core/ingestion.js';
 export { SearchEngine } from './search.js';
 export { IngestionPipeline } from './ingestion.js';
-export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine } from './embedder.js';
-export { config, validateConfig, getModelDefaults, type Config } from './config.js';
-export { openDatabase, initializeSchema, insertDocument, insertChunk, getChunksByEmbeddingIds, getModelVersion, setModelVersion, type DatabaseConnection, type ChunkResult } from './db.js';
-export { discoverFiles, processFiles, discoverAndProcessFiles, DEFAULT_FILE_PROCESSOR_OPTIONS, type FileProcessorOptions, type FileDiscoveryResult, type DocumentProcessingResult } from './file-processor.js';
-export { countTokens } from './tokenizer.js';
-export { VectorIndex } from './vector-index.js';
+export { LazyEmbedderLoader, LazyRerankerLoader, LazyMultimodalLoader, LazyDependencyManager } from './core/lazy-dependency-loader.js';
+export type { EmbedFunction, RerankFunction, EmbeddingQueryInterface, RerankingInterface, SearchEngineConfig, ContentTypeStrategy, ModelAgnosticInterface, ExtendedEmbeddingInterface, ExtendedRerankingInterface, SearchPipelineInterface, SearchDependencyFactory } from './core/interfaces.js';
+export { InterfaceValidator } from './core/interfaces.js';
+export { validateModeModelCompatibility, validateModeModelCompatibilityOrThrow, getRecommendedModelsForMode, isModeModelCompatible, getCompatibleModelsForMode, type ModeModelValidationResult } from './core/mode-model-validator.js';
+export { createMissingFileError, createInvalidPathError, createModelLoadingError, createDimensionMismatchError, createModeMismatchError, createInvalidContentError, createMissingDependencyError, createFactoryCreationError, enhanceError, createContextualError, type ActionableErrorConfig } from './core/actionable-error-messages.js';
+export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine, createTextEmbedFunction, createTextEmbedder } from './text/embedder.js';
+export type { UniversalEmbedder } from './core/universal-embedder.js';
+export { CLIPEmbedder } from './multimodal/clip-embedder.js';
+export { createEmbedder } from './core/embedder-factory.js';
+export { CrossEncoderReranker, createTextRerankFunction, createTextReranker } from './text/reranker.js';
+export { countTokens } from './text/tokenizer.js';
+export type { RerankingStrategyType, RerankingConfig } from './core/reranking-config.js';
+export { validateRerankingStrategy, validateRerankingConfig, getDefaultRerankingConfig, isStrategySupported, getSupportedStrategies, RerankingConfigBuilder, DEFAULT_TEXT_RERANKING_CONFIG, DEFAULT_MULTIMODAL_RERANKING_CONFIG } from './core/reranking-config.js';
+export { openDatabase, initializeSchema, insertDocument, insertChunk, upsertDocument, getChunksByEmbeddingIds, getModelVersion, setModelVersion, getStoredModelInfo, setStoredModelInfo, type DatabaseConnection } from './core/db.js';
 export { IndexManager } from './index-manager.js';
-export { ResourceManager } from './resource-manager.js';
+export { VectorIndex } from './core/vector-index.js';
+export { config, getModelDefaults, type CoreConfig, type ExtensibleConfig, type ModelDefaults, EXIT_CODES, ConfigurationError, getDefaultModelCachePath, handleUnrecoverableError, logError } from './core/config.js';
+export { discoverFiles, processFiles, discoverAndProcessFiles, DEFAULT_FILE_PROCESSOR_OPTIONS, type FileProcessorOptions, type FileDiscoveryResult, type DocumentProcessingResult } from './file-processor.js';
+export { chunkDocument, type ChunkConfig } from './core/chunker.js';
+export { DocumentPathManager } from './core/path-manager.js';
+export { resolveRagLitePaths, ensureRagLiteStructure, migrateToRagLiteStructure, getStandardRagLitePaths, type RagLiteConfig, type RagLitePaths } from './core/raglite-paths.js';
+export type { SearchResult, SearchOptions, Document, EmbeddingResult, ContentDocument, ContentChunk } from './core/types.js';
+export type { Chunk, Preprocessor, PreprocessorOptions, PreprocessingConfig } from './types.js';
+export type { IngestionOptions, IngestionResult } from './core/ingestion.js';
+export { handleError, safeExecute, ErrorCategory, ErrorSeverity, createError, type ErrorContext } from './core/error-handler.js';
 export { APIError, IngestionError, SearchError, ResourceError, ModelCompatibilityError, ErrorFactory, CommonErrors, handleAPIError } from './api-errors.js';
-export type { SearchResult, SearchOptions, Chunk, Document, EmbeddingResult, Preprocessor, PreprocessorOptions, PreprocessingConfig } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,21 +1,107 @@
-// Main entry point for rag-lite-ts
-// Core API classes (simple interface matching README)
+/**
+ * rag-lite-ts - Clean Architecture with Factory Pattern
+ *
+ * Quick Start (Recommended):
+ * ```typescript
+ * import { SearchFactory, IngestionFactory } from 'rag-lite-ts';
+ *
+ * // Simple search - just works!
+ * const search = await SearchFactory.create('./index.bin', './db.sqlite');
+ * const results = await search.search('your query');
+ *
+ * // Simple ingestion - just works!
+ * const ingestion = await IngestionFactory.create('./db.sqlite', './index.bin');
+ * await ingestion.ingestDirectory('./documents');
+ * ```
+ *
+ * With Configuration:
+ * ```typescript
+ * const search = await SearchFactory.create('./index.bin', './db.sqlite', {
+ *   embeddingModel: 'Xenova/all-mpnet-base-v2',
+ *   enableReranking: true
+ * });
+ * ```
+ *
+ * Complete RAG System:
+ * ```typescript
+ * import { RAGFactory } from 'rag-lite-ts';
+ *
+ * const { searchEngine, ingestionPipeline } = await RAGFactory.createBoth(
+ *   './index.bin',
+ *   './db.sqlite'
+ * );
+ * ```
+ *
+ * Advanced Usage (Direct Dependency Injection):
+ * ```typescript
+ * import { CoreSearchEngine, createTextEmbedFunction } from 'rag-lite-ts';
+ *
+ * const embedFn = await createTextEmbedFunction();
+ * const search = new CoreSearchEngine(embedFn, indexManager, db);
+ * ```
+ */
+// =============================================================================
+// PRIMARY API (FACTORY PATTERN)
+// =============================================================================
+// Main factory classes for simple usage
+export { TextSearchFactory, TextIngestionFactory, TextRAGFactory, TextFactoryHelpers } from './factories/index.js';
+// Convenience aliases for common usage
+export { TextSearchFactory as SearchFactory, TextIngestionFactory as IngestionFactory, TextRAGFactory as RAGFactory } from './factories/index.js';
+// =============================================================================
+// CORE ARCHITECTURE (FOR LIBRARY AUTHORS)
+// =============================================================================
+// Core classes for direct dependency injection (advanced)
+export { SearchEngine as CoreSearchEngine } from './core/search.js';
+export { IngestionPipeline as CoreIngestionPipeline } from './core/ingestion.js';
+// Public API classes
 export { SearchEngine } from './search.js';
 export { IngestionPipeline } from './ingestion.js';
-// Embedding operations (required for README examples)
-export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine } from './embedder.js';
-// Configuration (documented in README API reference)
-export { config, validateConfig, getModelDefaults } from './config.js';
-// Database operations (documented in README API reference)
-export { openDatabase, initializeSchema, insertDocument, insertChunk, getChunksByEmbeddingIds, getModelVersion, setModelVersion } from './db.js';
-// File processing operations (documented in README API reference)
-export { discoverFiles, processFiles, discoverAndProcessFiles, DEFAULT_FILE_PROCESSOR_OPTIONS } from './file-processor.js';
-// Tokenization (documented in README API reference)
-export { countTokens } from './tokenizer.js';
-// Advanced/Internal operations (for backward compatibility and advanced use cases)
-export { VectorIndex } from './vector-index.js';
+// Lazy loading system for performance optimization
+export { LazyEmbedderLoader, LazyRerankerLoader, LazyMultimodalLoader, LazyDependencyManager } from './core/lazy-dependency-loader.js';
+// Interface validation utilities
+export { InterfaceValidator } from './core/interfaces.js';
+// Mode-model compatibility validation
+export { validateModeModelCompatibility, validateModeModelCompatibilityOrThrow, getRecommendedModelsForMode, isModeModelCompatible, getCompatibleModelsForMode } from './core/mode-model-validator.js';
+// Actionable error messages
+export { createMissingFileError, createInvalidPathError, createModelLoadingError, createDimensionMismatchError, createModeMismatchError, createInvalidContentError, createMissingDependencyError, createFactoryCreationError, enhanceError, createContextualError } from './core/actionable-error-messages.js';
+// =============================================================================
+// TEXT IMPLEMENTATIONS (FOR CUSTOM DEPENDENCY INJECTION)
+// =============================================================================
+// Text-specific embedding implementations
+export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine, createTextEmbedFunction, createTextEmbedder } from './text/embedder.js';
+export { CLIPEmbedder } from './multimodal/clip-embedder.js';
+export { createEmbedder } from './core/embedder-factory.js';
+// Text-specific reranking implementations
+export { CrossEncoderReranker, createTextRerankFunction, createTextReranker } from './text/reranker.js';
+// Text tokenization utilities
+export { countTokens } from './text/tokenizer.js';
+export { validateRerankingStrategy, validateRerankingConfig, getDefaultRerankingConfig, isStrategySupported, getSupportedStrategies, RerankingConfigBuilder, DEFAULT_TEXT_RERANKING_CONFIG, DEFAULT_MULTIMODAL_RERANKING_CONFIG } from './core/reranking-config.js';
+// =============================================================================
+// CORE INFRASTRUCTURE (FOR ADVANCED USERS)
+// =============================================================================
+// Database operations
+export { openDatabase, initializeSchema, insertDocument, insertChunk, upsertDocument, getChunksByEmbeddingIds, getModelVersion, setModelVersion, getStoredModelInfo, setStoredModelInfo } from './core/db.js';
+// Vector index management
 export { IndexManager } from './index-manager.js';
-export { ResourceManager } from './resource-manager.js';
-// Error handling
+export { VectorIndex } from './core/vector-index.js';
+// Configuration and utilities
+export { config, getModelDefaults, EXIT_CODES, ConfigurationError, getDefaultModelCachePath, handleUnrecoverableError, logError } from './core/config.js';
+// =============================================================================
+// FILE PROCESSING AND UTILITIES
+// =============================================================================
+// File processing operations
+export { discoverFiles, processFiles, discoverAndProcessFiles, DEFAULT_FILE_PROCESSOR_OPTIONS } from './file-processor.js';
+// Document chunking
+export { chunkDocument } from './core/chunker.js';
+// Path management
+export { DocumentPathManager } from './core/path-manager.js';
+// RAG-lite directory structure management
+export { resolveRagLitePaths, ensureRagLiteStructure, migrateToRagLiteStructure, getStandardRagLitePaths } from './core/raglite-paths.js';
+// =============================================================================
+// ERROR HANDLING
+// =============================================================================
+// Core error handling
+export { handleError, safeExecute, ErrorCategory, ErrorSeverity, createError } from './core/error-handler.js';
+// API-specific errors
 export { APIError, IngestionError, SearchError, ResourceError, ModelCompatibilityError, ErrorFactory, CommonErrors, handleAPIError } from './api-errors.js';
 //# sourceMappingURL=index.js.map

package/dist/indexer.js

@@ -4,7 +4,7 @@
  * Usage: node indexer.js <path>
  */
 import { runIngest } from './cli/indexer.js';
-import { EXIT_CODES, ConfigurationError } from './config.js';
+import { EXIT_CODES, ConfigurationError } from './core/config.js';
 async function main() {
     const args = process.argv.slice(2);
     if (args.length === 0) {

package/dist/ingestion.d.ts

@@ -1,175 +1,65 @@
-import { type FileProcessorOptions } from './file-processor.js';
-import { type ChunkConfig } from './chunker.js';
-import { type EmbeddingEngine } from './embedder.js';
-import { Config } from './config.js';
 /**
- * User-friendly error class with actionable suggestions
+ * Public API IngestionPipeline - Simple constructor interface with internal factory usage
+ *
+ * This class provides a clean, simple API while using the new core architecture
+ * internally. It handles dependency injection automatically.
+ *
+ * @example
+ * ```typescript
+ * // Simple usage
+ * const pipeline = new IngestionPipeline('./db.sqlite', './index.bin');
+ * await pipeline.ingestDirectory('./documents');
+ *
+ * // With options
+ * const pipeline = new IngestionPipeline('./db.sqlite', './index.bin', {
+ *   embeddingModel: 'all-MiniLM-L6-v2',
+ *   chunkSize: 512
+ * });
+ * ```
  */
-export declare class IngestionError extends Error {
-    code: string;
-    suggestions: string[];
-    constructor(message: string, code: string, suggestions: string[]);
+import { type TextIngestionOptions } from './factories/index.js';
+import type { IngestionOptions, IngestionResult } from './core/ingestion.js';
+import type { MemoryContentMetadata } from './core/content-manager.js';
+export interface IngestionPipelineOptions extends TextIngestionOptions {
 }
-/**
- * Options for the ingestion pipeline
- */
-export interface IngestionOptions {
-    /** File processing options */
-    fileOptions?: FileProcessorOptions;
-    /** Chunking configuration */
-    chunkConfig?: ChunkConfig;
-    /** Whether to force rebuild the index */
-    forceRebuild?: boolean;
-}
-/**
- * Result of the ingestion process
- */
-export interface IngestionResult {
-    /** Total documents processed */
-    documentsProcessed: number;
-    /** Total chunks created */
-    chunksCreated: number;
-    /** Total embeddings generated */
-    embeddingsGenerated: number;
-    /** Number of documents that failed processing */
-    documentErrors: number;
-    /** Number of chunks that failed embedding */
-    embeddingErrors: number;
-    /** Processing time in milliseconds */
-    processingTimeMs: number;
-}
-/**
- * Main ingestion pipeline class
- * Coordinates the entire process from file discovery to vector storage
- */
 export declare class IngestionPipeline {
-    private static instances;
-    private static cleanupHandlersSet;
-    private db;
-    private indexManager;
-    private embeddingEngine;
-    private pathManager;
-    private isInitialized;
     private dbPath;
     private indexPath;
-    private basePath;
-    private configOverrides;
+    private options;
+    private corePipeline;
+    private initPromise;
+    private defaultChunkConfig;
+    constructor(dbPath: string, indexPath: string, options?: IngestionPipelineOptions);
     /**
-     * Creates a new IngestionPipeline with simplified constructor
-     * Pipeline is ready to use immediately without requiring initialization calls (Requirement 1.5)
-     * @param basePath - Base directory path for database and index files (defaults to current directory)
-     * @param embedder - Pre-initialized embedding engine (optional, will use default if not provided)
+     * Initialize the ingestion pipeline using the factory
      */
-    constructor(basePath?: string, embedder?: EmbeddingEngine);
+    private initialize;
     /**
-     * Set configuration overrides (for internal use)
-     * @param overrides - Configuration overrides to apply
+     * Ingest a single document
      */
-    setConfigOverrides(overrides: Partial<Config>): void;
+    ingestDocument(filePath: string, options?: IngestionOptions): Promise<IngestionResult>;
     /**
-     * Set path storage strategy
-     * @param strategy - Path storage strategy ('absolute' or 'relative')
-     * @param basePath - Base path for relative paths (optional, defaults to current base path)
-     */
-    setPathStorageStrategy(strategy: 'absolute' | 'relative', basePath?: string): void;
-    /**
-     * Get effective configuration with overrides applied
-     */
-    private getEffectiveConfig;
-    /**
-     * Automatically initialize resources on first use with user-friendly error handling
-     * Implements lazy initialization as required by 5.2
-     */
-    private ensureInitialized;
-    /**
-     * Create user-friendly error messages with actionable suggestions
-     * Implements requirement 5.3: Clear, actionable error messages with specific next steps
-     */
-    private createUserFriendlyError;
-    /**
-     * Initialize the ingestion pipeline (public method for backward compatibility)
-     * Sets up database, index manager, and embedding engine
-     */
-    initialize(): Promise<void>;
-    /**
-     * Ingest documents from a directory (matches README API)
-     * Automatically initializes resources on first use (Requirements 2.1, 2.3, 5.2)
-     * @param directoryPath - Path to directory containing documents
-     * @param options - Optional ingestion configuration
-     * @returns Promise resolving to ingestion results
+     * Ingest all documents in a directory
      */
     ingestDirectory(directoryPath: string, options?: IngestionOptions): Promise<IngestionResult>;
     /**
-     * Ingest a single file (matches README API)
-     * Automatically initializes resources on first use (Requirements 2.2, 2.3, 5.2)
-     * @param filePath - Path to the file to ingest
-     * @param options - Optional ingestion configuration
-     * @returns Promise resolving to ingestion results
-     */
-    ingestFile(filePath: string, options?: IngestionOptions): Promise<IngestionResult>;
-    /**
-     * Ingest documents from a path (file or directory)
-     * Implements the complete pipeline: file processing → chunking → embedding → storage
+     * Ingest content from memory buffer
+     * Enables MCP integration and real-time content processing
      *
-     * Requirements addressed:
-     * - 7.5: Single-threaded write processing to avoid SQLite lock contention
-     * - 3.3: Graceful handling of embedding failures without stopping ingestion
-     * - 10.1: Progress logging and error reporting during batch ingestion
-     * - 2.3: Automatic creation of database and index files in appropriate locations
-     */
-    ingestPath(path: string, options?: IngestionOptions): Promise<IngestionResult>;
-    /**
-     * Chunk all documents and organize results
-     */
-    private chunkDocuments;
-    /**
-     * Generate embeddings for all chunks with error handling
-     * Requirement 3.3: Graceful handling of embedding failures without stopping ingestion
-     */
-    private generateEmbeddings;
-    /**
-     * Store documents and chunks in database with single-threaded writes
-     * Requirement 7.5: Single-threaded write processing to avoid SQLite lock contention
-     */
-    private storeDocumentsAndChunks;
-    /**
-     * Update vector index with new embeddings
-     */
-    private updateVectorIndex;
-    /**
-     * Initialize the pipeline for rebuild (skips model compatibility check)
-     */
-    private initializeForRebuild;
-    /**
-     * Rebuild the entire index from scratch
-     * Useful when model version changes or for maintenance
-     * Automatically initializes resources if needed (Requirement 5.2)
-     */
-    rebuildIndex(): Promise<void>;
-    /**
-     * Get pipeline statistics
-     */
-    getStats(): Promise<{
-        indexStats: any;
-        isInitialized: boolean;
-    }>;
-    /**
-     * Set up automatic cleanup on process exit (Requirement 5.5)
-     */
-    private setupAutomaticCleanup;
+     * @example
+     * ```typescript
+     * const pipeline = new IngestionPipeline('./db.sqlite', './index.bin');
+     * const contentId = await pipeline.ingestFromMemory(buffer, {
+     *   displayName: 'uploaded-file.txt',
+     *   contentType: 'text/plain'
+     * });
+     * console.log('Content ingested with ID:', contentId);
+     * ```
+     */
+    ingestFromMemory(content: Buffer, metadata: MemoryContentMetadata, options?: IngestionOptions): Promise<string>;
     /**
      * Clean up resources
      */
     cleanup(): Promise<void>;
 }
-/**
- * Convenience function to ingest documents from a path
- * Creates a pipeline instance, runs ingestion, and cleans up
- */
-export declare function ingestDocuments(path: string, options?: IngestionOptions): Promise<IngestionResult>;
-/**
- * Convenience function to rebuild the index
- * Creates a pipeline instance, rebuilds index, and cleans up
- */
-export declare function rebuildIndex(): Promise<void>;
 //# sourceMappingURL=ingestion.d.ts.map