fix: add embedder validation to prevent misleading status indicators (#4398)

src/core/webview/webviewMessageHandler.ts

@@ -1830,8 +1830,12 @@ export const webviewMessageHandler = async (
 			const settings = message.codeIndexSettings
 
 			try {
-				// Save global state settings atomically (without codebaseIndexEnabled which is now in global settings)
+				// Check if embedder provider has changed
 				const currentConfig = getGlobalState("codebaseIndexConfig") || {}
+				const embedderProviderChanged =
+					currentConfig.codebaseIndexEmbedderProvider !== settings.codebaseIndexEmbedderProvider
+
+				// Save global state settings atomically (without codebaseIndexEnabled which is now in global settings)
 				const globalStateConfig = {
 					...currentConfig,
 					codebaseIndexQdrantUrl: settings.codebaseIndexQdrantUrl,
@@ -1867,31 +1871,70 @@ export const webviewMessageHandler = async (
 					)
 				}
 
-				// Verify secrets are actually stored
-				const storedOpenAiKey = provider.contextProxy.getSecret("codeIndexOpenAiKey")
+				// Send success response first - settings are saved regardless of validation
+				await provider.postMessageToWebview({
+					type: "codeIndexSettingsSaved",
+					success: true,
+					settings: globalStateConfig,
+				})
 
-				// Notify code index manager of changes
+				// Update webview state
+				await provider.postStateToWebview()
+
+				// Then handle validation and initialization
 				if (provider.codeIndexManager) {
-					await provider.codeIndexManager.handleSettingsChange()
+					// If embedder provider changed, perform proactive validation
+					if (embedderProviderChanged) {
+						try {
+							// Force handleSettingsChange which will trigger validation
+							await provider.codeIndexManager.handleSettingsChange()
+						} catch (error) {
+							// Validation failed - the error state is already set by handleSettingsChange
+							provider.log(
+								`Embedder validation failed after provider change: ${error instanceof Error ? error.message : String(error)}`,
+							)
+							// Send validation error to webview
+							await provider.postMessageToWebview({
+								type: "indexingStatusUpdate",
+								values: provider.codeIndexManager.getCurrentStatus(),
+							})
+							// Exit early - don't try to start indexing with invalid configuration
+							break
+						}
+					} else {
+						// No provider change, just handle settings normally
+						try {
+							await provider.codeIndexManager.handleSettingsChange()
+						} catch (error) {
+							// Log but don't fail - settings are saved
+							provider.log(
+								`Settings change handling error: ${error instanceof Error ? error.message : String(error)}`,
+							)
+						}
+					}
+
+					// Wait a bit more to ensure everything is ready
+					await new Promise((resolve) => setTimeout(resolve, 200))
 
 					// Auto-start indexing if now enabled and configured
 					if (provider.codeIndexManager.isFeatureEnabled && provider.codeIndexManager.isFeatureConfigured) {
 						if (!provider.codeIndexManager.isInitialized) {
-							await provider.codeIndexManager.initialize(provider.contextProxy)
+							try {
+								await provider.codeIndexManager.initialize(provider.contextProxy)
+								provider.log(`Code index manager initialized after settings save`)
+							} catch (error) {
+								provider.log(
+									`Code index initialization failed: ${error instanceof Error ? error.message : String(error)}`,
+								)
+								// Send error status to webview
+								await provider.postMessageToWebview({
+									type: "indexingStatusUpdate",
+									values: provider.codeIndexManager.getCurrentStatus(),
+								})
+							}
 						}
-						provider.codeIndexManager.startIndexing()
 					}
 				}
-
-				// Send success response
-				await provider.postMessageToWebview({
-					type: "codeIndexSettingsSaved",
-					success: true,
-					settings: globalStateConfig,
-				})
-
-				// Update webview state
-				await provider.postStateToWebview()
 			} catch (error) {
 				provider.log(`Error saving code index settings: ${error.message || error}`)
 				await provider.postMessageToWebview({

src/i18n/locales/ca/embeddings.json

@@ -10,7 +10,12 @@
 		"couldNotReadErrorBody": "No s'ha pogut llegir el cos de l'error",
 		"requestFailed": "La sol·licitud de l'API d'Ollama ha fallat amb l'estat {{status}} {{statusText}}: {{errorBody}}",
 		"invalidResponseStructure": "Estructura de resposta no vàlida de l'API d'Ollama: no s'ha trobat la matriu \"embeddings\" o no és una matriu.",
-		"embeddingFailed": "La incrustació d'Ollama ha fallat: {{message}}"
+		"embeddingFailed": "La incrustació d'Ollama ha fallat: {{message}}",
+		"serviceNotRunning": "El servei d'Ollama no s'està executant a {{baseUrl}}",
+		"serviceUnavailable": "El servei d'Ollama no està disponible (estat: {{status}})",
+		"modelNotFound": "No s'ha trobat el model d'Ollama: {{modelId}}",
+		"modelNotEmbeddingCapable": "El model d'Ollama no és capaç de fer incrustacions: {{modelId}}",
+		"hostNotFound": "No s'ha trobat l'amfitrió d'Ollama: {{baseUrl}}"
 	},
 	"scanner": {
 		"unknownErrorProcessingFile": "Error desconegut en processar el fitxer {{filePath}}",
@@ -19,5 +24,18 @@
 	},
 	"vectorStore": {
 		"qdrantConnectionFailed": "No s'ha pogut connectar a la base de dades vectorial Qdrant. Assegura't que Qdrant estigui funcionant i sigui accessible a {{qdrantUrl}}. Error: {{errorMessage}}"
+	},
+	"validation": {
+		"authenticationFailed": "Ha fallat l'autenticació. Comproveu la vostra clau d'API a la configuració.",
+		"connectionFailed": "No s'ha pogut connectar al servei d'incrustació. Comproveu la vostra configuració de connexió i assegureu-vos que el servei estigui funcionant.",
+		"modelNotAvailable": "El model especificat no està disponible. Comproveu la vostra configuració de model.",
+		"configurationError": "Configuració d'incrustació no vàlida. Reviseu la vostra configuració.",
+		"serviceUnavailable": "El servei d'incrustació no està disponible. Assegureu-vos que estigui funcionant i sigui accessible.",
+		"invalidEndpoint": "Punt final d'API no vàlid. Comproveu la vostra configuració d'URL.",
+		"invalidEmbedderConfig": "Configuració d'incrustació no vàlida. Comproveu la vostra configuració.",
+		"invalidApiKey": "Clau d'API no vàlida. Comproveu la vostra configuració de clau d'API.",
+		"invalidBaseUrl": "URL base no vàlida. Comproveu la vostra configuració d'URL.",
+		"invalidModel": "Model no vàlid. Comproveu la vostra configuració de model.",
+		"invalidResponse": "Resposta no vàlida del servei d'incrustació. Comproveu la vostra configuració."
 	}
 }

src/i18n/locales/de/embeddings.json

@@ -10,7 +10,12 @@
 		"couldNotReadErrorBody": "Fehlerinhalt konnte nicht gelesen werden",
 		"requestFailed": "Ollama API-Anfrage fehlgeschlagen mit Status {{status}} {{statusText}}: {{errorBody}}",
 		"invalidResponseStructure": "Ungültige Antwortstruktur von Ollama API: \"embeddings\" Array nicht gefunden oder kein Array.",
-		"embeddingFailed": "Ollama Einbettung fehlgeschlagen: {{message}}"
+		"embeddingFailed": "Ollama Einbettung fehlgeschlagen: {{message}}",
+		"serviceNotRunning": "Ollama-Dienst wird unter {{baseUrl}} nicht ausgeführt",
+		"serviceUnavailable": "Ollama-Dienst ist nicht verfügbar (Status: {{status}})",
+		"modelNotFound": "Ollama-Modell nicht gefunden: {{modelId}}",
+		"modelNotEmbeddingCapable": "Ollama-Modell ist nicht für Einbettungen geeignet: {{modelId}}",
+		"hostNotFound": "Ollama-Host nicht gefunden: {{baseUrl}}"
 	},
 	"scanner": {
 		"unknownErrorProcessingFile": "Unbekannter Fehler beim Verarbeiten der Datei {{filePath}}",
@@ -19,5 +24,18 @@
 	},
 	"vectorStore": {
 		"qdrantConnectionFailed": "Verbindung zur Qdrant-Vektordatenbank fehlgeschlagen. Stelle sicher, dass Qdrant läuft und unter {{qdrantUrl}} erreichbar ist. Fehler: {{errorMessage}}"
+	},
+	"validation": {
+		"authenticationFailed": "Authentifizierung fehlgeschlagen. Bitte überprüfe deinen API-Schlüssel in den Einstellungen.",
+		"connectionFailed": "Verbindung zum Embedder-Dienst fehlgeschlagen. Bitte überprüfe deine Verbindungseinstellungen und stelle sicher, dass der Dienst läuft.",
+		"modelNotAvailable": "Das angegebene Modell ist nicht verfügbar. Bitte überprüfe deine Modellkonfiguration.",
+		"configurationError": "Ungültige Embedder-Konfiguration. Bitte überprüfe deine Einstellungen.",
+		"serviceUnavailable": "Der Embedder-Dienst ist nicht verfügbar. Bitte stelle sicher, dass er läuft und erreichbar ist.",
+		"invalidEndpoint": "Ungültiger API-Endpunkt. Bitte überprüfe deine URL-Konfiguration.",
+		"invalidEmbedderConfig": "Ungültige Embedder-Konfiguration. Bitte überprüfe deine Einstellungen.",
+		"invalidApiKey": "Ungültiger API-Schlüssel. Bitte überprüfe deine API-Schlüssel-Konfiguration.",
+		"invalidBaseUrl": "Ungültige Basis-URL. Bitte überprüfe deine URL-Konfiguration.",
+		"invalidModel": "Ungültiges Modell. Bitte überprüfe deine Modellkonfiguration.",
+		"invalidResponse": "Ungültige Antwort vom Embedder-Dienst. Bitte überprüfe deine Konfiguration."
 	}
 }

src/i18n/locales/en/embeddings.json

@@ -10,7 +10,12 @@
 		"couldNotReadErrorBody": "Could not read error body",
 		"requestFailed": "Ollama API request failed with status {{status}} {{statusText}}: {{errorBody}}",
 		"invalidResponseStructure": "Invalid response structure from Ollama API: \"embeddings\" array not found or not an array.",
-		"embeddingFailed": "Ollama embedding failed: {{message}}"
+		"embeddingFailed": "Ollama embedding failed: {{message}}",
+		"serviceNotRunning": "Ollama service is not running at {{baseUrl}}",
+		"serviceUnavailable": "Ollama service is unavailable (status: {{status}})",
+		"modelNotFound": "Ollama model not found: {{modelId}}",
+		"modelNotEmbeddingCapable": "Ollama model is not embedding capable: {{modelId}}",
+		"hostNotFound": "Ollama host not found: {{baseUrl}}"
 	},
 	"scanner": {
 		"unknownErrorProcessingFile": "Unknown error processing file {{filePath}}",
@@ -19,5 +24,18 @@
 	},
 	"vectorStore": {
 		"qdrantConnectionFailed": "Failed to connect to Qdrant vector database. Please ensure Qdrant is running and accessible at {{qdrantUrl}}. Error: {{errorMessage}}"
+	},
+	"validation": {
+		"authenticationFailed": "Authentication failed. Please check your API key in the settings.",
+		"connectionFailed": "Failed to connect to the embedder service. Please check your connection settings and ensure the service is running.",
+		"modelNotAvailable": "The specified model is not available. Please check your model configuration.",
+		"configurationError": "Invalid embedder configuration. Please review your settings.",
+		"serviceUnavailable": "The embedder service is not available. Please ensure it is running and accessible.",
+		"invalidEndpoint": "Invalid API endpoint. Please check your URL configuration.",
+		"invalidEmbedderConfig": "Invalid embedder configuration. Please check your settings.",
+		"invalidApiKey": "Invalid API key. Please check your API key configuration.",
+		"invalidBaseUrl": "Invalid base URL. Please check your URL configuration.",
+		"invalidModel": "Invalid model. Please check your model configuration.",
+		"invalidResponse": "Invalid response from embedder service. Please check your configuration."
 	}
 }

src/i18n/locales/es/embeddings.json

@@ -10,7 +10,12 @@
 		"couldNotReadErrorBody": "No se pudo leer el cuerpo del error",
 		"requestFailed": "La solicitud de la API de Ollama falló con estado {{status}} {{statusText}}: {{errorBody}}",
 		"invalidResponseStructure": "Estructura de respuesta inválida de la API de Ollama: array \"embeddings\" no encontrado o no es un array.",
-		"embeddingFailed": "Incrustación de Ollama falló: {{message}}"
+		"embeddingFailed": "Incrustación de Ollama falló: {{message}}",
+		"serviceNotRunning": "El servicio Ollama no se está ejecutando en {{baseUrl}}",
+		"serviceUnavailable": "El servicio Ollama no está disponible (estado: {{status}})",
+		"modelNotFound": "No se encuentra el modelo Ollama: {{modelId}}",
+		"modelNotEmbeddingCapable": "El modelo Ollama no es capaz de realizar incrustaciones: {{modelId}}",
+		"hostNotFound": "No se encuentra el host de Ollama: {{baseUrl}}"
 	},
 	"scanner": {
 		"unknownErrorProcessingFile": "Error desconocido procesando archivo {{filePath}}",
@@ -19,5 +24,18 @@
 	},
 	"vectorStore": {
 		"qdrantConnectionFailed": "Error al conectar con la base de datos vectorial Qdrant. Asegúrate de que Qdrant esté funcionando y sea accesible en {{qdrantUrl}}. Error: {{errorMessage}}"
+	},
+	"validation": {
+		"authenticationFailed": "Error de autenticación. Comprueba tu clave de API en los ajustes.",
+		"connectionFailed": "Error al conectar con el servicio de embedder. Comprueba los ajustes de conexión y asegúrate de que el servicio esté funcionando.",
+		"modelNotAvailable": "El modelo especificado no está disponible. Comprueba la configuración de tu modelo.",
+		"configurationError": "Configuración de embedder no válida. Revisa tus ajustes.",
+		"serviceUnavailable": "El servicio de embedder no está disponible. Asegúrate de que esté funcionando y sea accesible.",
+		"invalidEndpoint": "Punto de conexión de API no válido. Comprueba la configuración de tu URL.",
+		"invalidEmbedderConfig": "Configuración de embedder no válida. Comprueba tus ajustes.",
+		"invalidApiKey": "Clave de API no válida. Comprueba la configuración de tu clave de API.",
+		"invalidBaseUrl": "URL base no válida. Comprueba la configuración de tu URL.",
+		"invalidModel": "Modelo no válido. Comprueba la configuración de tu modelo.",
+		"invalidResponse": "Respuesta no válida del servicio de embedder. Comprueba tu configuración."
 	}
 }

src/i18n/locales/fr/embeddings.json

@@ -10,7 +10,12 @@
 		"couldNotReadErrorBody": "Impossible de lire le corps de l'erreur",
 		"requestFailed": "Échec de la requête API Ollama avec le statut {{status}} {{statusText}} : {{errorBody}}",
 		"invalidResponseStructure": "Structure de réponse invalide de l'API Ollama : tableau \"embeddings\" non trouvé ou n'est pas un tableau.",
-		"embeddingFailed": "Échec de l'embedding Ollama : {{message}}"
+		"embeddingFailed": "Échec de l'embedding Ollama : {{message}}",
+		"serviceNotRunning": "Le service Ollama n'est pas en cours d'exécution sur {{baseUrl}}",
+		"serviceUnavailable": "Le service Ollama est indisponible (statut : {{status}})",
+		"modelNotFound": "Modèle Ollama introuvable : {{modelId}}",
+		"modelNotEmbeddingCapable": "Le modèle Ollama n'est pas capable d'intégrer : {{modelId}}",
+		"hostNotFound": "Hôte Ollama introuvable : {{baseUrl}}"
 	},
 	"scanner": {
 		"unknownErrorProcessingFile": "Erreur inconnue lors du traitement du fichier {{filePath}}",
@@ -19,5 +24,18 @@
 	},
 	"vectorStore": {
 		"qdrantConnectionFailed": "Échec de la connexion à la base de données vectorielle Qdrant. Veuillez vous assurer que Qdrant fonctionne et est accessible à {{qdrantUrl}}. Erreur : {{errorMessage}}"
+	},
+	"validation": {
+		"authenticationFailed": "Échec de l'authentification. Veuillez vérifier votre clé API dans les paramètres.",
+		"connectionFailed": "Échec de la connexion au service d'embedding. Veuillez vérifier vos paramètres de connexion et vous assurer que le service est en cours d'exécution.",
+		"modelNotAvailable": "Le modèle spécifié n'est pas disponible. Veuillez vérifier la configuration de votre modèle.",
+		"configurationError": "Configuration de l'embedder invalide. Veuillez vérifier vos paramètres.",
+		"serviceUnavailable": "Le service d'embedding n'est pas disponible. Veuillez vous assurer qu'il est en cours d'exécution et accessible.",
+		"invalidEndpoint": "Point de terminaison d'API invalide. Veuillez vérifier votre configuration d'URL.",
+		"invalidEmbedderConfig": "Configuration de l'embedder invalide. Veuillez vérifier vos paramètres.",
+		"invalidApiKey": "Clé API invalide. Veuillez vérifier votre configuration de clé API.",
+		"invalidBaseUrl": "URL de base invalide. Veuillez vérifier votre configuration d'URL.",
+		"invalidModel": "Modèle invalide. Veuillez vérifier votre configuration de modèle.",
+		"invalidResponse": "Réponse invalide du service d'embedder. Veuillez vérifier votre configuration."
 	}
 }

src/i18n/locales/hi/embeddings.json

@@ -10,7 +10,12 @@
 		"couldNotReadErrorBody": "त्रुटि सामग्री पढ़ नहीं सका",
 		"requestFailed": "Ollama API अनुरोध स्थिति {{status}} {{statusText}} के साथ विफल: {{errorBody}}",
 		"invalidResponseStructure": "Ollama API से अमान्य प्रतिक्रिया संरचना: \"embeddings\" सरणी नहीं मिली या सरणी नहीं है।",
-		"embeddingFailed": "Ollama एम्बेडिंग विफल: {{message}}"
+		"embeddingFailed": "Ollama एम्बेडिंग विफल: {{message}}",
+		"serviceNotRunning": "ओलामा सेवा {{baseUrl}} पर नहीं चल रही है",
+		"serviceUnavailable": "ओलामा सेवा अनुपलब्ध है (स्थिति: {{status}})",
+		"modelNotFound": "ओलामा मॉडल नहीं मिला: {{modelId}}",
+		"modelNotEmbeddingCapable": "ओलामा मॉडल एम्बेडिंग में सक्षम नहीं है: {{modelId}}",
+		"hostNotFound": "ओलामा होस्ट नहीं मिला: {{baseUrl}}"
 	},
 	"scanner": {
 		"unknownErrorProcessingFile": "फ़ाइल {{filePath}} प्रसंस्करण में अज्ञात त्रुटि",
@@ -19,5 +24,18 @@
 	},
 	"vectorStore": {
 		"qdrantConnectionFailed": "Qdrant वेक्टर डेटाबेस से कनेक्ट करने में विफल। कृपया सुनिश्चित करें कि Qdrant चल रहा है और {{qdrantUrl}} पर पहुंच योग्य है। त्रुटि: {{errorMessage}}"
+	},
+	"validation": {
+		"authenticationFailed": "प्रमाणीकरण विफल। कृपया सेटिंग्स में अपनी एपीआई कुंजी जांचें।",
+		"connectionFailed": "एम्बेडर सेवा से कनेक्ट करने में विफल। कृपया अपनी कनेक्शन सेटिंग्स जांचें और सुनिश्चित करें कि सेवा चल रही है।",
+		"modelNotAvailable": "निर्दिष्ट मॉडल उपलब्ध नहीं है। कृपया अपनी मॉडल कॉन्फ़िगरेशन जांचें।",
+		"configurationError": "अमान्य एम्बेडर कॉन्फ़िगरेशन। कृपया अपनी सेटिंग्स की समीक्षा करें।",
+		"serviceUnavailable": "एम्बेडर सेवा उपलब्ध नहीं है। कृपया सुनिश्चित करें कि यह चल रहा है और पहुंच योग्य है।",
+		"invalidEndpoint": "अमान्य एपीआई एंडपॉइंट। कृपया अपनी यूआरएल कॉन्फ़िगरेशन जांचें।",
+		"invalidEmbedderConfig": "अमान्य एम्बेडर कॉन्फ़िगरेशन। कृपया अपनी सेटिंग्स जांचें।",
+		"invalidApiKey": "अमान्य एपीआई कुंजी। कृपया अपनी एपीआई कुंजी कॉन्फ़िगरेशन जांचें।",
+		"invalidBaseUrl": "अमान्य बेस यूआरएल। कृपया अपनी यूआरएल कॉन्फ़िगरेशन जांचें।",
+		"invalidModel": "अमान्य मॉडल। कृपया अपनी मॉडल कॉन्फ़िगरेशन जांचें।",
+		"invalidResponse": "एम्बेडर सेवा से अमान्य प्रतिक्रिया। कृपया अपनी कॉन्फ़िगरेशन जांचें।"
 	}
 }