rag-lite-ts 1.0.2 → 2.0.0

package/dist/core/mode-detection-service.d.ts

@@ -0,0 +1,150 @@
+/**
+ * CORE MODULE — Mode Detection Service for Chameleon Architecture
+ * Handles automatic mode detection from database and provides default configurations
+ * Supports graceful error handling and fallback to text mode
+ * Enhanced with shared database connection management to prevent locking issues
+ */
+import type { DatabaseConnection } from './db.js';
+import type { SystemInfo, ModeType, ModelType } from '../types.js';
+/**
+ * Service for detecting and storing system mode configuration
+ * Provides automatic mode detection from database with graceful error handling
+ * Uses shared database connections to prevent locking issues
+ */
+export declare class ModeDetectionService {
+    private dbPath;
+    constructor(dbPath: string);
+    /**
+     * Detects the current system mode from the database
+     * Falls back to default text mode configuration for new installations
+     * Enhanced with comprehensive error handling and recovery mechanisms
+     * Uses shared database connections to prevent locking issues
+     *
+     * @param existingConnection - Optional existing connection to reuse
+     * @returns Promise resolving to SystemInfo with current or default configuration
+     *
+     * @example
+     * ```typescript
+     * const modeService = new ModeDetectionService('./db.sqlite');
+     * const systemInfo = await modeService.detectMode();
+     * console.log(`Current mode: ${systemInfo.mode}`);
+     * ```
+     */
+    detectMode(existingConnection?: DatabaseConnection): Promise<SystemInfo>;
+    /**
+     * Stores system mode configuration in the database
+     * Creates or updates the system_info table with the provided configuration
+     * Uses shared database connections to prevent locking issues
+     *
+     * @param systemInfo - SystemInfo object to store (can be partial for updates)
+     * @param existingConnection - Optional existing connection to reuse
+     *
+     * @example
+     * ```typescript
+     * const modeService = new ModeDetectionService('./db.sqlite');
+     * await modeService.storeMode({
+     *   mode: 'multimodal',
+     *   modelName: 'Xenova/clip-vit-base-patch32',
+     *   modelType: 'clip',
+     *   modelDimensions: 512,
+     *   supportedContentTypes: ['text', 'image'],
+     *   rerankingStrategy: 'text-derived'
+     * });
+     * ```
+     */
+    storeMode(systemInfo: Partial<SystemInfo>, existingConnection?: DatabaseConnection): Promise<void>;
+    /**
+     * Gets the current mode from the database (convenience method)
+     * @returns Promise resolving to the current mode string
+     */
+    getCurrentMode(): Promise<ModeType>;
+    /**
+     * Checks if the system is in multimodal mode
+     * @returns Promise resolving to boolean indicating multimodal mode
+     */
+    isMultimodalMode(): Promise<boolean>;
+    /**
+     * Gets complete model information from the database
+     * @returns Promise resolving to current model configuration
+     */
+    getCurrentModelInfo(): Promise<{
+        modelName: string;
+        modelType: ModelType;
+        dimensions: number;
+        supportedContentTypes: string[];
+    }>;
+    /**
+     * Get default system info for new installations
+     * @private
+     */
+    private getDefaultSystemInfo;
+    /**
+     * Check database file accessibility
+     * @private
+     */
+    private checkDatabaseAccessibility;
+    /**
+     * Verify database schema integrity
+     * @private
+     */
+    private verifySchemaIntegrity;
+    /**
+     * Ensure database schema exists
+     * @private
+     */
+    private ensureSchemaExists;
+    /**
+     * Handle detection errors with fallback to default configuration
+     * @private
+     */
+    private handleDetectionError;
+    /**
+     * Log error-specific guidance for users
+     * @private
+     */
+    private logErrorGuidance;
+    /**
+     * Enhances storage errors with more context and helpful suggestions
+     * @private
+     */
+    private enhanceStorageError;
+    /**
+     * Validate complete system info object
+     * @private
+     */
+    private validateSystemInfo;
+    /**
+     * Validate mode value
+     * @private
+     */
+    private validateMode;
+    /**
+     * Validate model type value
+     * @private
+     */
+    private validateModelType;
+    /**
+     * Validate reranking strategy value
+     * @private
+     */
+    private validateRerankingStrategy;
+}
+/**
+ * Quick function to detect mode from database
+ * @param dbPath - Path to database file
+ * @returns Promise resolving to SystemInfo
+ */
+export declare function detectSystemMode(dbPath: string): Promise<SystemInfo>;
+/**
+ * Quick function to store mode configuration
+ * @param dbPath - Path to database file
+ * @param systemInfo - System configuration to store
+ */
+export declare function storeSystemMode(dbPath: string, systemInfo: Partial<SystemInfo>): Promise<void>;
+/**
+ * Quick function to check if system is in multimodal mode
+ * @param dbPath - Path to database file
+ * @returns Promise resolving to boolean
+ */
+export declare function isMultimodalMode(dbPath: string): Promise<boolean>;
+//# sourceMappingURL=mode-detection-service.d.ts.map