@vfarcic/dot-ai 1.2.4 → 1.3.0

package/dist/interfaces/rest-api.js

@@ -45,6 +45,7 @@ const openapi_generator_1 = require("./openapi-generator");
 const rest_route_registry_1 = require("./rest-route-registry");
 const routes_1 = require("./routes");
 const resource_sync_handler_1 = require("./resource-sync-handler");
+const embedding_migration_handler_1 = require("./embedding-migration-handler");
 const prompts_1 = require("../tools/prompts");
 const generic_session_manager_1 = require("../core/generic-session-manager");
 const shared_prompt_loader_1 = require("../core/shared-prompt-loader");
@@ -90,7 +91,7 @@ class RestApiRouter {
             version: 'v1',
             enableCors: true,
             requestTimeout: 1800000, // 30 minutes for long-running operations (capability scan with slower AI providers)
-            ...config
+            ...config,
         };
         // Initialize route registry and register all routes (PRD #354)
         this.routeRegistry = new rest_route_registry_1.RestRouteRegistry(logger);
@@ -118,7 +119,7 @@ class RestApiRouter {
                 requestId,
                 method: req.method,
                 url: req.url,
-                hasBody: !!body
+                hasBody: !!body,
             });
             // Handle CORS preflight
             if (this.config.enableCors) {
@@ -162,7 +163,7 @@ class RestApiRouter {
         catch (error) {
             this.logger.error('REST API request failed', error instanceof Error ? error : new Error(String(error)), {
                 requestId,
-                errorMessage: error instanceof Error ? error.message : String(error)
+                errorMessage: error instanceof Error ? error.message : String(error),
             });
             await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'INTERNAL_ERROR', 'An internal server error occurred');
         }
@@ -193,13 +194,17 @@ class RestApiRouter {
             'GET:/api/v1/sessions/:sessionId': () => this.handleSessionRetrieval(req, res, requestId, params.sessionId),
             'DELETE:/api/v1/knowledge/source/:sourceIdentifier': () => this.handleDeleteKnowledgeSource(req, res, requestId, params.sourceIdentifier),
             'POST:/api/v1/knowledge/ask': () => this.handleKnowledgeAsk(req, res, requestId, body),
+            'POST:/api/v1/embeddings/migrate': () => this.handleEmbeddingMigrationRequest(req, res, requestId, body),
         };
         const handler = handlers[routeKey];
         if (handler) {
             await handler();
         }
         else {
-            this.logger.warn('Route matched but no handler found', { requestId, routeKey });
+            this.logger.warn('Route matched but no handler found', {
+                requestId,
+                routeKey,
+            });
             await this.sendErrorResponse(res, requestId, HttpStatus.NOT_FOUND, 'NOT_FOUND', 'Handler not found for route');
         }
     }
@@ -220,19 +225,19 @@ class RestApiRouter {
                     tools,
                     total: tools.length,
                     categories,
-                    tags
+                    tags,
                 },
                 meta: {
                     timestamp: new Date().toISOString(),
                     requestId,
-                    version: this.config.version
-                }
+                    version: this.config.version,
+                },
             };
             await this.sendJsonResponse(res, HttpStatus.OK, response);
             this.logger.info('Tool discovery request completed', {
                 requestId,
                 totalTools: tools.length,
-                filters: { category, tag, search }
+                filters: { category, tag, search },
             });
         }
         catch {
@@ -258,7 +263,7 @@ class RestApiRouter {
             this.logger.info('Executing tool via REST API', {
                 requestId,
                 toolName,
-                parameters: Object.keys(body)
+                parameters: Object.keys(body),
             });
             // Execute the tool handler with timeout
             // Note: Tool handlers expect the same format as MCP calls
@@ -268,7 +273,7 @@ class RestApiRouter {
             const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error('Request timeout exceeded')), timeoutMs));
             // Prevent unhandled rejection if toolPromise resolves after timeout
             toolPromise.catch(() => { });
-            const mcpResult = await Promise.race([toolPromise, timeoutPromise]);
+            const mcpResult = (await Promise.race([toolPromise, timeoutPromise]));
             // Transform MCP format to proper REST JSON
             // All MCP tools return JSON.stringify() in content[0].text, so parse it back to proper JSON
             let transformedResult;
@@ -280,7 +285,9 @@ class RestApiRouter {
                     this.logger.warn('Failed to parse MCP tool result as JSON, returning as text', {
                         requestId,
                         toolName,
-                        error: parseError instanceof Error ? parseError.message : String(parseError)
+                        error: parseError instanceof Error
+                            ? parseError.message
+                            : String(parseError),
                     });
                     transformedResult = mcpResult.content[0].text;
                 }
@@ -295,20 +302,20 @@ class RestApiRouter {
                 data: {
                     result: transformedResult,
                     tool: toolName,
-                    executionTime
+                    executionTime,
                 },
                 meta: {
                     timestamp: new Date().toISOString(),
                     requestId,
-                    version: this.config.version
-                }
+                    version: this.config.version,
+                },
             };
             await this.sendJsonResponse(res, HttpStatus.OK, response);
             this.logger.info('Tool execution completed', {
                 requestId,
                 toolName,
                 executionTime,
-                success: true
+                success: true,
             });
         }
         catch (error) {
@@ -316,7 +323,7 @@ class RestApiRouter {
             this.logger.error('Tool execution failed', error instanceof Error ? error : new Error(String(error)), {
                 requestId,
                 toolName,
-                errorMessage
+                errorMessage,
             });
             await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'EXECUTION_ERROR', errorMessage);
         }
@@ -332,13 +339,13 @@ class RestApiRouter {
             this.logger.info('OpenAPI specification served successfully', {
                 requestId,
                 pathCount: Object.keys(spec.paths).length,
-                componentCount: Object.keys(spec.components?.schemas || {}).length
+                componentCount: Object.keys(spec.components?.schemas || {}).length,
             });
         }
         catch (error) {
             this.logger.error('Failed to generate OpenAPI specification', error instanceof Error ? error : new Error(String(error)), {
                 requestId,
-                errorMessage: error instanceof Error ? error.message : String(error)
+                errorMessage: error instanceof Error ? error.message : String(error),
             });
             await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'OPENAPI_ERROR', 'Failed to generate OpenAPI specification');
         }
@@ -360,10 +367,13 @@ class RestApiRouter {
             let httpStatus = HttpStatus.OK;
             if (!response.success) {
                 const errorCode = response.error?.code;
-                if (errorCode === 'VECTOR_DB_UNAVAILABLE' || errorCode === 'HEALTH_CHECK_FAILED') {
+                if (errorCode === 'VECTOR_DB_UNAVAILABLE' ||
+                    errorCode === 'HEALTH_CHECK_FAILED') {
                     httpStatus = HttpStatus.SERVICE_UNAVAILABLE;
                 }
-                else if (errorCode === 'SERVICE_INIT_FAILED' || errorCode === 'COLLECTION_INIT_FAILED' || errorCode === 'RESYNC_FAILED') {
+                else if (errorCode === 'SERVICE_INIT_FAILED' ||
+                    errorCode === 'COLLECTION_INIT_FAILED' ||
+                    errorCode === 'RESYNC_FAILED') {
                     httpStatus = HttpStatus.INTERNAL_SERVER_ERROR;
                 }
                 else {
@@ -375,14 +385,14 @@ class RestApiRouter {
                 requestId,
                 success: response.success,
                 upserted: response.data?.upserted,
-                deleted: response.data?.deleted
+                deleted: response.data?.deleted,
             });
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
             this.logger.error('Resource sync request failed', error instanceof Error ? error : new Error(String(error)), {
                 requestId,
-                errorMessage
+                errorMessage,
             });
             await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'SYNC_ERROR', 'Resource sync failed', { error: errorMessage });
         }
@@ -395,30 +405,33 @@ class RestApiRouter {
     async handleGetResourceKinds(req, res, requestId, searchParams) {
         try {
             const namespace = searchParams.get('namespace') || undefined;
-            this.logger.info('Processing get resource kinds request', { requestId, namespace });
+            this.logger.info('Processing get resource kinds request', {
+                requestId,
+                namespace,
+            });
             const kinds = await (0, resource_tools_1.getResourceKinds)(namespace);
             const response = {
                 success: true,
                 data: {
-                    kinds
+                    kinds,
                 },
                 meta: {
                     timestamp: new Date().toISOString(),
                     requestId,
-                    version: this.config.version
-                }
+                    version: this.config.version,
+                },
             };
             await this.sendJsonResponse(res, HttpStatus.OK, response);
             this.logger.info('Get resource kinds request completed', {
                 requestId,
-                kindCount: kinds.length
+                kindCount: kinds.length,
             });
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
             this.logger.error('Get resource kinds request failed', error instanceof Error ? error : new Error(String(error)), {
                 requestId,
-                errorMessage
+                errorMessage,
             });
             await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'RESOURCE_KINDS_ERROR', 'Failed to retrieve resource kinds', { error: errorMessage });
         }
@@ -454,7 +467,8 @@ class RestApiRouter {
                 await this.sendErrorResponse(res, requestId, HttpStatus.BAD_REQUEST, 'INVALID_PARAMETER', 'The "offset" parameter must be a non-negative integer');
                 return;
             }
-            if (minScoreParam && (isNaN(minScore) || minScore < 0 || minScore > 1)) {
+            if (minScoreParam &&
+                (isNaN(minScore) || minScore < 0 || minScore > 1)) {
                 await this.sendErrorResponse(res, requestId, HttpStatus.BAD_REQUEST, 'INVALID_PARAMETER', 'The "minScore" parameter must be a number between 0 and 1');
                 return;
             }
@@ -466,7 +480,7 @@ class RestApiRouter {
                 apiVersion,
                 limit,
                 offset,
-                minScore
+                minScore,
             });
             // Build filters
             const filters = {};
@@ -492,7 +506,7 @@ class RestApiRouter {
                 apiVersion: r.resource.apiVersion,
                 labels: r.resource.labels || {},
                 createdAt: r.resource.createdAt,
-                score: r.score
+                score: r.score,
             }));
             const response = {
                 success: true,
@@ -500,27 +514,27 @@ class RestApiRouter {
                     resources,
                     total: results.length,
                     limit,
-                    offset
+                    offset,
                 },
                 meta: {
                     timestamp: new Date().toISOString(),
                     requestId,
-                    version: this.config.version
-                }
+                    version: this.config.version,
+                },
             };
             await this.sendJsonResponse(res, HttpStatus.OK, response);
             this.logger.info('Search resources request completed', {
                 requestId,
                 query: q,
                 resultCount: resources.length,
-                totalMatches: results.length
+                totalMatches: results.length,
             });
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
             this.logger.error('Search resources request failed', error instanceof Error ? error : new Error(String(error)), {
                 requestId,
-                errorMessage
+                errorMessage,
             });
             await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'SEARCH_ERROR', 'Failed to search resources', { error: errorMessage });
         }
@@ -567,14 +581,22 @@ class RestApiRouter {
                 namespace,
                 includeStatus,
                 limit,
-                offset
+                offset,
             });
             // PRD #343: Never pass includeStatus to listResources (it uses direct kubectl)
             // Fetch status via plugin separately if requested
-            const result = await (0, resource_tools_1.listResources)({ kind, apiVersion, namespace, limit, offset });
+            const result = await (0, resource_tools_1.listResources)({
+                kind,
+                apiVersion,
+                namespace,
+                limit,
+                offset,
+            });
             // Enrich with live status via plugin if requested
             // PRD #359: Use unified plugin registry
-            if (includeStatus && result.resources.length > 0 && (0, plugin_registry_1.isPluginInitialized)()) {
+            if (includeStatus &&
+                result.resources.length > 0 &&
+                (0, plugin_registry_1.isPluginInitialized)()) {
                 const statusPromises = result.resources.map(async (resource) => {
                     const resourceType = resource.apiGroup
                         ? `${resource.kind.toLowerCase()}.${resource.apiGroup}`
@@ -583,7 +605,7 @@ class RestApiRouter {
                     const pluginResponse = await (0, plugin_registry_1.invokePluginTool)('agentic-tools', 'kubectl_get_resource_json', {
                         resource: resourceId,
                         namespace: resource.namespace,
-                        field: 'status'
+                        field: 'status',
                     });
                     if (pluginResponse.success && pluginResponse.result) {
                         const pluginResult = pluginResponse.result;
@@ -606,22 +628,22 @@ class RestApiRouter {
                 meta: {
                     timestamp: new Date().toISOString(),
                     requestId,
-                    version: this.config.version
-                }
+                    version: this.config.version,
+                },
             };
             await this.sendJsonResponse(res, HttpStatus.OK, response);
             this.logger.info('List resources request completed', {
                 requestId,
                 resourceCount: result.resources.length,
                 total: result.total,
-                includeStatus
+                includeStatus,
             });
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
             this.logger.error('List resources request failed', error instanceof Error ? error : new Error(String(error)), {
                 requestId,
-                errorMessage
+                errorMessage,
             });
             await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'LIST_RESOURCES_ERROR', 'Failed to list resources', { error: errorMessage });
         }
@@ -637,25 +659,25 @@ class RestApiRouter {
             const response = {
                 success: true,
                 data: {
-                    namespaces
+                    namespaces,
                 },
                 meta: {
                     timestamp: new Date().toISOString(),
                     requestId,
-                    version: this.config.version
-                }
+                    version: this.config.version,
+                },
             };
             await this.sendJsonResponse(res, HttpStatus.OK, response);
             this.logger.info('Get namespaces request completed', {
                 requestId,
-                namespaceCount: namespaces.length
+                namespaceCount: namespaces.length,
             });
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
             this.logger.error('Get namespaces request failed', error instanceof Error ? error : new Error(String(error)), {
                 requestId,
-                errorMessage
+                errorMessage,
             });
             await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'NAMESPACES_ERROR', 'Failed to retrieve namespaces', { error: errorMessage });
         }
@@ -683,7 +705,13 @@ class RestApiRouter {
                 await this.sendErrorResponse(res, requestId, HttpStatus.BAD_REQUEST, 'BAD_REQUEST', 'name query parameter is required');
                 return;
             }
-            this.logger.info('Processing get resource request', { requestId, kind, apiVersion, name, namespace });
+            this.logger.info('Processing get resource request', {
+                requestId,
+                kind,
+                apiVersion,
+                name,
+                namespace,
+            });
             // Extract apiGroup from apiVersion (e.g., "apps/v1" -> "apps", "v1" -> "")
             const apiGroup = apiVersion.includes('/') ? apiVersion.split('/')[0] : '';
             // PRD #359: Use unified plugin registry
@@ -692,12 +720,14 @@ class RestApiRouter {
                 return;
             }
             // Build resource identifier (kind.group/name or kind/name for core resources)
-            const resourceType = apiGroup ? `${kind.toLowerCase()}.${apiGroup}` : kind.toLowerCase();
+            const resourceType = apiGroup
+                ? `${kind.toLowerCase()}.${apiGroup}`
+                : kind.toLowerCase();
             const resourceId = `${resourceType}/${name}`;
             // PRD #359: Use unified plugin registry for kubectl operations
             const pluginResponse = await (0, plugin_registry_1.invokePluginTool)('agentic-tools', 'kubectl_get_resource_json', {
                 resource: resourceId,
-                namespace: namespace
+                namespace: namespace,
             });
             // Check for plugin-level failures first
             if (!pluginResponse.success) {
@@ -734,27 +764,27 @@ class RestApiRouter {
             const response = {
                 success: true,
                 data: {
-                    resource
+                    resource,
                 },
                 meta: {
                     timestamp: new Date().toISOString(),
                     requestId,
-                    version: this.config.version
-                }
+                    version: this.config.version,
+                },
             };
             await this.sendJsonResponse(res, HttpStatus.OK, response);
             this.logger.info('Get resource request completed', {
                 requestId,
                 kind,
                 name,
-                namespace
+                namespace,
             });
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
             this.logger.error('Get resource request failed', error instanceof Error ? error : new Error(String(error)), {
                 requestId,
-                errorMessage
+                errorMessage,
             });
             await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'RESOURCE_ERROR', 'Failed to retrieve resource', { error: errorMessage });
         }
@@ -778,7 +808,13 @@ class RestApiRouter {
                 await this.sendErrorResponse(res, requestId, HttpStatus.BAD_REQUEST, 'BAD_REQUEST', 'kind query parameter is required');
                 return;
             }
-            this.logger.info('Processing get events request', { requestId, name, kind, namespace, uid });
+            this.logger.info('Processing get events request', {
+                requestId,
+                name,
+                kind,
+                namespace,
+                uid,
+            });
             // PRD #359: Use unified plugin registry
             if (!(0, plugin_registry_1.isPluginInitialized)()) {
                 await this.sendErrorResponse(res, requestId, HttpStatus.SERVICE_UNAVAILABLE, 'PLUGIN_UNAVAILABLE', 'Plugin system not initialized');
@@ -787,7 +823,7 @@ class RestApiRouter {
             // Build field selector for involvedObject filtering
             const fieldSelectors = [
                 `involvedObject.name=${name}`,
-                `involvedObject.kind=${kind}`
+                `involvedObject.kind=${kind}`,
             ];
             if (uid) {
                 fieldSelectors.push(`involvedObject.uid=${uid}`);
@@ -795,7 +831,7 @@ class RestApiRouter {
             // PRD #359: Use unified plugin registry for kubectl operations
             const pluginResponse = await (0, plugin_registry_1.invokePluginTool)('agentic-tools', 'kubectl_events', {
                 namespace: namespace,
-                args: [`--field-selector=${fieldSelectors.join(',')}`]
+                args: [`--field-selector=${fieldSelectors.join(',')}`],
             });
             const events = [];
             if (pluginResponse.success && pluginResponse.result) {
@@ -803,7 +839,9 @@ class RestApiRouter {
                 if (pluginResult.success && pluginResult.data) {
                     // Parse the table output or handle JSON if available
                     // Events output is typically table format, so we need to parse it
-                    const lines = pluginResult.data.split('\n').filter(line => line.trim());
+                    const lines = pluginResult.data
+                        .split('\n')
+                        .filter(line => line.trim());
                     if (lines.length > 1) {
                         // Skip header line, parse remaining lines
                         for (let i = 1; i < lines.length; i++) {
@@ -814,7 +852,7 @@ class RestApiRouter {
                                     type: parts[1],
                                     reason: parts[2],
                                     involvedObject: { kind, name },
-                                    message: parts.slice(4).join(' ')
+                                    message: parts.slice(4).join(' '),
                                 });
                             }
                         }
@@ -825,13 +863,13 @@ class RestApiRouter {
                 success: true,
                 data: {
                     events,
-                    count: events.length
+                    count: events.length,
                 },
                 meta: {
                     timestamp: new Date().toISOString(),
                     requestId,
-                    version: this.config.version
-                }
+                    version: this.config.version,
+                },
             };
             await this.sendJsonResponse(res, HttpStatus.OK, response);
             this.logger.info('Get events request completed', {
@@ -839,14 +877,14 @@ class RestApiRouter {
                 name,
                 kind,
                 namespace,
-                eventCount: events.length
+                eventCount: events.length,
             });
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
             this.logger.error('Get events request failed', error instanceof Error ? error : new Error(String(error)), {
                 requestId,
-                errorMessage
+                errorMessage,
             });
             await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'EVENTS_ERROR', 'Failed to retrieve events', { error: errorMessage });
         }
@@ -879,7 +917,13 @@ class RestApiRouter {
                     return;
                 }
             }
-            this.logger.info('Processing get logs request', { requestId, name, namespace, container, tailLines });
+            this.logger.info('Processing get logs request', {
+                requestId,
+                name,
+                namespace,
+                container,
+                tailLines,
+            });
             // PRD #359: Use unified plugin registry
             if (!(0, plugin_registry_1.isPluginInitialized)()) {
                 await this.sendErrorResponse(res, requestId, HttpStatus.SERVICE_UNAVAILABLE, 'PLUGIN_UNAVAILABLE', 'Plugin system not initialized');
@@ -897,7 +941,7 @@ class RestApiRouter {
             const pluginResponse = await (0, plugin_registry_1.invokePluginTool)('agentic-tools', 'kubectl_logs', {
                 resource: name,
                 namespace: namespace,
-                args: args.length > 0 ? args : undefined
+                args: args.length > 0 ? args : undefined,
             });
             if (!pluginResponse.success) {
                 const errorMsg = pluginResponse.error?.message || 'Failed to retrieve logs';
@@ -914,13 +958,13 @@ class RestApiRouter {
                 data: {
                     logs: result.data,
                     container: container || 'default',
-                    containerCount: 1
+                    containerCount: 1,
                 },
                 meta: {
                     timestamp: new Date().toISOString(),
                     requestId,
-                    version: this.config.version
-                }
+                    version: this.config.version,
+                },
             };
             await this.sendJsonResponse(res, HttpStatus.OK, response);
             this.logger.info('Get logs request completed', {
@@ -928,14 +972,14 @@ class RestApiRouter {
                 name,
                 namespace,
                 container: container || 'default',
-                logLength: result.data.length
+                logLength: result.data.length,
             });
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
             this.logger.error('Get logs request failed', error instanceof Error ? error : new Error(String(error)), {
                 requestId,
-                errorMessage
+                errorMessage,
             });
             await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'LOGS_ERROR', 'Failed to retrieve logs', { error: errorMessage });
         }
@@ -953,18 +997,18 @@ class RestApiRouter {
                 meta: {
                     timestamp: new Date().toISOString(),
                     requestId,
-                    version: this.config.version
-                }
+                    version: this.config.version,
+                },
             };
             await this.sendJsonResponse(res, HttpStatus.OK, response);
             this.logger.info('Prompts list request completed', {
                 requestId,
-                promptCount: result.prompts?.length || 0
+                promptCount: result.prompts?.length || 0,
             });
         }
         catch (error) {
             this.logger.error('Prompts list request failed', error instanceof Error ? error : new Error(String(error)), {
-                requestId
+                requestId,
             });
             await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'PROMPTS_LIST_ERROR', 'Failed to list prompts');
         }
@@ -974,7 +1018,10 @@ class RestApiRouter {
      */
     async handlePromptsGetRequest(req, res, requestId, promptName, body) {
         try {
-            this.logger.info('Processing prompt get request', { requestId, promptName });
+            this.logger.info('Processing prompt get request', {
+                requestId,
+                promptName,
+            });
             const bodyObj = body;
             const result = await (0, prompts_1.handlePromptsGetRequest)({ name: promptName, arguments: bodyObj?.arguments }, this.logger, requestId);
             const response = {
@@ -983,25 +1030,27 @@ class RestApiRouter {
                 meta: {
                     timestamp: new Date().toISOString(),
                     requestId,
-                    version: this.config.version
-                }
+                    version: this.config.version,
+                },
             };
             await this.sendJsonResponse(res, HttpStatus.OK, response);
             this.logger.info('Prompt get request completed', {
                 requestId,
-                promptName
+                promptName,
             });
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
             this.logger.error('Prompt get request failed', error instanceof Error ? error : new Error(String(error)), {
                 requestId,
-                promptName
+                promptName,
             });
             // Check if it's a validation error (missing required arguments or prompt not found)
             const isValidationError = errorMessage.includes('Missing required arguments') ||
                 errorMessage.includes('Prompt not found');
-            await this.sendErrorResponse(res, requestId, isValidationError ? HttpStatus.BAD_REQUEST : HttpStatus.INTERNAL_SERVER_ERROR, isValidationError ? 'VALIDATION_ERROR' : 'PROMPT_GET_ERROR', errorMessage);
+            await this.sendErrorResponse(res, requestId, isValidationError
+                ? HttpStatus.BAD_REQUEST
+                : HttpStatus.INTERNAL_SERVER_ERROR, isValidationError ? 'VALIDATION_ERROR' : 'PROMPT_GET_ERROR', errorMessage);
         }
     }
     /**
@@ -1020,7 +1069,7 @@ class RestApiRouter {
                 requestId,
                 sessionIds,
                 isMultiSession,
-                reload
+                reload,
             });
             // Fetch all sessions
             const sessions = [];
@@ -1037,11 +1086,13 @@ class RestApiRouter {
             // For single session, check cache (multi-session doesn't use cache yet)
             // PRD #320: Skip cache if reload=true to regenerate from current session data
             const primarySession = sessions[0];
-            if (!isMultiSession && !reload && primarySession.data.cachedVisualization) {
+            if (!isMultiSession &&
+                !reload &&
+                primarySession.data.cachedVisualization) {
                 this.logger.info('Returning cached visualization', {
                     requestId,
                     sessionId: sessionIds[0],
-                    generatedAt: primarySession.data.cachedVisualization.generatedAt
+                    generatedAt: primarySession.data.cachedVisualization.generatedAt,
                 });
                 const cachedResponse = {
                     success: true,
@@ -1049,13 +1100,13 @@ class RestApiRouter {
                         title: primarySession.data.cachedVisualization.title,
                         visualizations: primarySession.data.cachedVisualization.visualizations,
                         insights: primarySession.data.cachedVisualization.insights,
-                        toolsUsed: primarySession.data.cachedVisualization.toolsUsed // PRD #320
+                        toolsUsed: primarySession.data.cachedVisualization.toolsUsed, // PRD #320
                     },
                     meta: {
                         timestamp: new Date().toISOString(),
                         requestId,
-                        version: this.config.version
-                    }
+                        version: this.config.version,
+                    },
                 };
                 await this.sendJsonResponse(res, HttpStatus.OK, cachedResponse);
                 return;
@@ -1069,7 +1120,12 @@ class RestApiRouter {
             // PRD #320: Select prompt based on tool name (defaults to 'query' for backwards compatibility)
             const toolName = (primarySession.data.toolName || 'query');
             const promptName = (0, visualization_1.getPromptForTool)(toolName);
-            this.logger.info('Loading visualization prompt', { requestId, sessionIds, toolName, promptName });
+            this.logger.info('Loading visualization prompt', {
+                requestId,
+                sessionIds,
+                toolName,
+                promptName,
+            });
             // Load system prompt with session context
             // PRD #320: Unified visualization prompt with tool-aware data selection
             let intent;
@@ -1079,7 +1135,9 @@ class RestApiRouter {
             switch (toolName) {
                 case 'recommend':
                     intent = sessionData.intent || '';
-                    data = isMultiSession ? sessions.map(s => s.data) : primarySession.data;
+                    data = isMultiSession
+                        ? sessions.map(s => s.data)
+                        : primarySession.data;
                     break;
                 case 'remediate':
                     intent = sessionData.issue || '';
@@ -1102,15 +1160,17 @@ class RestApiRouter {
             const promptData = {
                 intent,
                 data: JSON.stringify(data, null, 2),
-                visualizationOutput: (0, shared_prompt_loader_1.loadPrompt)('partials/visualization-output')
+                visualizationOutput: (0, shared_prompt_loader_1.loadPrompt)('partials/visualization-output'),
             };
             const systemPrompt = (0, shared_prompt_loader_1.loadPrompt)(promptName, promptData);
             // PRD #343: Local executor for non-plugin tools (capability, resource, mermaid)
             const localToolExecutor = async (toolName, input) => {
-                if (toolName.startsWith('search_capabilities') || toolName.startsWith('query_capabilities')) {
+                if (toolName.startsWith('search_capabilities') ||
+                    toolName.startsWith('query_capabilities')) {
                     return (0, capability_tools_1.executeCapabilityTools)(toolName, input);
                 }
-                if (toolName.startsWith('search_resources') || toolName.startsWith('query_resources')) {
+                if (toolName.startsWith('search_resources') ||
+                    toolName.startsWith('query_resources')) {
                     return (0, resource_tools_1.executeResourceTools)(toolName, input);
                 }
                 // PRD #320: Mermaid validation tools
@@ -1120,7 +1180,7 @@ class RestApiRouter {
                 return {
                     success: false,
                     error: `Unknown tool: ${toolName}`,
-                    message: `Tool '${toolName}' is not implemented in visualization`
+                    message: `Tool '${toolName}' is not implemented in visualization`,
                 };
             };
             // PRD #343: Use plugin executor for kubectl tools, local for others
@@ -1134,42 +1194,57 @@ class RestApiRouter {
                 'kubectl_describe',
                 'kubectl_logs',
                 'kubectl_events',
-                'kubectl_get_crd_schema'
+                'kubectl_get_crd_schema',
             ];
             const pluginKubectlTools = this.pluginManager
-                ? this.pluginManager.getDiscoveredTools().filter(t => KUBECTL_READONLY_TOOL_NAMES.includes(t.name))
+                ? this.pluginManager
+                    .getDiscoveredTools()
+                    .filter(t => KUBECTL_READONLY_TOOL_NAMES.includes(t.name))
                 : [];
-            this.logger.info('Starting AI visualization generation with tools', { requestId, sessionIds, toolName });
+            this.logger.info('Starting AI visualization generation with tools', {
+                requestId,
+                sessionIds,
+                toolName,
+            });
             // Execute tool loop - AI can gather additional data if needed
             const result = await aiProvider.toolLoop({
                 systemPrompt,
                 userMessage: 'Generate visualizations based on the query results provided. Use tools if you need additional information about any resources.',
                 // PRD #320: Include MERMAID_TOOLS for diagram validation
                 // PRD #343: kubectl tools from plugin
-                tools: [...capability_tools_1.CAPABILITY_TOOLS, ...resource_tools_1.RESOURCE_TOOLS, ...pluginKubectlTools, ...mermaid_tools_1.MERMAID_TOOLS],
+                tools: [
+                    ...capability_tools_1.CAPABILITY_TOOLS,
+                    ...resource_tools_1.RESOURCE_TOOLS,
+                    ...pluginKubectlTools,
+                    ...mermaid_tools_1.MERMAID_TOOLS,
+                ],
                 toolExecutor: executeVisualizationTools,
                 maxIterations: 10, // Allow enough iterations for tool calls + JSON generation
-                operation: `visualize-${toolName}` // PRD #320: Include tool name for debugging
+                operation: `visualize-${toolName}`, // PRD #320: Include tool name for debugging
             });
             this.logger.info('AI visualization generation completed', {
                 requestId,
                 sessionIds,
                 toolName,
                 iterations: result.iterations,
-                toolsUsed: [...new Set(result.toolCallsExecuted.map(tc => tc.tool))]
+                toolsUsed: [...new Set(result.toolCallsExecuted.map(tc => tc.tool))],
             });
             // Parse AI response as JSON using shared function
             let visualizationResponse;
             let isFallbackResponse = false;
             try {
-                const toolsUsed = [...new Set(result.toolCallsExecuted.map(tc => tc.tool))];
+                const toolsUsed = [
+                    ...new Set(result.toolCallsExecuted.map(tc => tc.tool)),
+                ];
                 visualizationResponse = (0, visualization_1.parseVisualizationResponse)(result.finalMessage, toolsUsed);
             }
             catch (parseError) {
-                this.logger.error('Failed to parse AI visualization response', parseError instanceof Error ? parseError : new Error(String(parseError)), {
+                this.logger.error('Failed to parse AI visualization response', parseError instanceof Error
+                    ? parseError
+                    : new Error(String(parseError)), {
                     requestId,
                     sessionIds,
-                    rawResponse: result.finalMessage.substring(0, 500)
+                    rawResponse: result.finalMessage.substring(0, 500),
                 });
                 // Fallback to basic visualization on parse error
                 // NOTE: isFallbackResponse flag prevents caching this response
@@ -1183,13 +1258,13 @@ class RestApiRouter {
                             type: 'code',
                             content: {
                                 language: 'json',
-                                code: JSON.stringify(isMultiSession ? sessions.map(s => s.data) : primarySession.data, null, 2)
-                            }
-                        }
+                                code: JSON.stringify(isMultiSession
+                                    ? sessions.map(s => s.data)
+                                    : primarySession.data, null, 2),
+                            },
+                        },
                     ],
-                    insights: [
-                        'AI visualization generation failed - showing raw data'
-                    ]
+                    insights: ['AI visualization generation failed - showing raw data'],
                 };
             }
             // Cache the visualization in the session for subsequent requests (single session only)
@@ -1203,13 +1278,19 @@ class RestApiRouter {
                         visualizations: visualizationResponse.visualizations,
                         insights: visualizationResponse.insights,
                         toolsUsed: visualizationResponse.toolsUsed, // PRD #320: Cache toolsUsed
-                        generatedAt: new Date().toISOString()
-                    }
+                        generatedAt: new Date().toISOString(),
+                    },
+                });
+                this.logger.info('Visualization cached in session', {
+                    requestId,
+                    sessionId: sessionIds[0],
                 });
-                this.logger.info('Visualization cached in session', { requestId, sessionId: sessionIds[0] });
             }
             else if (isFallbackResponse) {
-                this.logger.warn('Skipping cache for fallback visualization response', { requestId, sessionId: sessionIds[0] });
+                this.logger.warn('Skipping cache for fallback visualization response', {
+                    requestId,
+                    sessionId: sessionIds[0],
+                });
             }
             const response = {
                 success: true,
@@ -1217,8 +1298,8 @@ class RestApiRouter {
                 meta: {
                     timestamp: new Date().toISOString(),
                     requestId,
-                    version: this.config.version
-                }
+                    version: this.config.version,
+                },
             };
             await this.sendJsonResponse(res, HttpStatus.OK, response);
             this.logger.info('Visualization request completed', {
@@ -1226,14 +1307,14 @@ class RestApiRouter {
                 sessionIds,
                 visualizationCount: visualizationResponse.visualizations.length,
                 cached: !isMultiSession && !isFallbackResponse,
-                isFallback: isFallbackResponse
+                isFallback: isFallbackResponse,
             });
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
             this.logger.error('Visualization request failed', error instanceof Error ? error : new Error(String(error)), {
                 requestId,
-                sessionIdParam
+                sessionIdParam,
             });
             await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'VISUALIZATION_ERROR', 'Failed to generate visualization', { error: errorMessage });
         }
@@ -1249,7 +1330,7 @@ class RestApiRouter {
             this.logger.info('Processing session retrieval', {
                 requestId,
                 sessionId,
-                sessionPrefix
+                sessionPrefix,
             });
             const sessionManager = new generic_session_manager_1.GenericSessionManager(sessionPrefix);
             const session = sessionManager.getSession(sessionId);
@@ -1263,21 +1344,21 @@ class RestApiRouter {
                 meta: {
                     timestamp: new Date().toISOString(),
                     requestId,
-                    version: this.config.version
-                }
+                    version: this.config.version,
+                },
             };
             await this.sendJsonResponse(res, HttpStatus.OK, response);
             this.logger.info('Session retrieved successfully', {
                 requestId,
                 sessionId,
-                toolName: session.data?.toolName || 'unknown'
+                toolName: session.data?.toolName || 'unknown',
             });
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
             this.logger.error('Session retrieval failed', error instanceof Error ? error : new Error(String(error)), {
                 requestId,
-                sessionId
+                sessionId,
             });
             await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'SESSION_RETRIEVAL_ERROR', 'Failed to retrieve session', { error: errorMessage });
         }
@@ -1306,7 +1387,12 @@ class RestApiRouter {
             const queryResponse = await (0, plugin_registry_1.invokePluginTool)(PLUGIN_NAME, 'vector_query', {
                 collection: KNOWLEDGE_COLLECTION,
                 filter: {
-                    must: [{ key: 'metadata.sourceIdentifier', match: { value: decodedSourceIdentifier } }],
+                    must: [
+                        {
+                            key: 'metadata.sourceIdentifier',
+                            match: { value: decodedSourceIdentifier },
+                        },
+                    ],
                 },
                 limit: 10000, // High limit to get all chunks for a source
             });
@@ -1314,7 +1400,8 @@ class RestApiRouter {
                 const error = queryResponse.error;
                 const errorMessage = error?.message || error?.error || 'Query failed';
                 // If collection doesn't exist (Not Found), return success with 0 deleted
-                if (errorMessage.includes('Not Found') || errorMessage.includes('not found')) {
+                if (errorMessage.includes('Not Found') ||
+                    errorMessage.includes('not found')) {
                     this.logger.info('Collection not found - returning success with 0 deleted', {
                         requestId,
                         sourceIdentifier: decodedSourceIdentifier,
@@ -1346,7 +1433,8 @@ class RestApiRouter {
             if (!queryResult.success) {
                 const errorMessage = queryResult.error || queryResult.message;
                 // If collection doesn't exist, return success with 0 deleted
-                if (errorMessage.includes('Not Found') || errorMessage.includes('not found')) {
+                if (errorMessage.includes('Not Found') ||
+                    errorMessage.includes('not found')) {
                     this.logger.info('Collection not found - returning success with 0 deleted', {
                         requestId,
                         sourceIdentifier: decodedSourceIdentifier,
@@ -1407,7 +1495,11 @@ class RestApiRouter {
                         chunkId: chunk.id,
                         deletedSoFar: deletedCount,
                     });
-                    await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'DELETE_SOURCE_ERROR', 'Failed to delete chunk', { chunkId: chunk.id, error: errorMessage, chunksDeletedBeforeFailure: deletedCount });
+                    await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'DELETE_SOURCE_ERROR', 'Failed to delete chunk', {
+                        chunkId: chunk.id,
+                        error: errorMessage,
+                        chunksDeletedBeforeFailure: deletedCount,
+                    });
                     return;
                 }
                 deletedCount++;
@@ -1452,7 +1544,7 @@ class RestApiRouter {
                 await this.sendErrorResponse(res, requestId, HttpStatus.BAD_REQUEST, 'BAD_REQUEST', 'Request body must be a JSON object');
                 return;
             }
-            const { query, limit = 20, uriFilter } = body;
+            const { query, limit = 20, uriFilter, } = body;
             // Validate limit parameter (must be positive integer)
             if (typeof limit !== 'number' || !Number.isInteger(limit) || limit < 1) {
                 await this.sendErrorResponse(res, requestId, HttpStatus.BAD_REQUEST, 'INVALID_PARAMETER', 'The "limit" parameter must be a positive integer');
@@ -1607,6 +1699,41 @@ class RestApiRouter {
             await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'SYNTHESIS_ERROR', 'Failed to process knowledge ask request', { error: errorMessage });
         }
     }
+    /**
+     * Handle embedding migration request (PRD #384)
+     */
+    async handleEmbeddingMigrationRequest(req, res, requestId, body) {
+        try {
+            this.logger.info('Processing embedding migration request', { requestId });
+            // Delegate to the embedding migration handler
+            const response = await (0, embedding_migration_handler_1.handleEmbeddingMigration)(body, this.logger, requestId);
+            // Determine HTTP status based on response
+            let httpStatus = HttpStatus.OK;
+            if (!response.success) {
+                const errorCode = response.error?.code;
+                if (errorCode === 'PLUGIN_UNAVAILABLE' ||
+                    errorCode === 'EMBEDDING_SERVICE_UNAVAILABLE') {
+                    httpStatus = HttpStatus.SERVICE_UNAVAILABLE;
+                }
+                else if (errorCode === 'MIGRATION_ERROR') {
+                    httpStatus = HttpStatus.INTERNAL_SERVER_ERROR;
+                }
+                else {
+                    httpStatus = HttpStatus.BAD_REQUEST;
+                }
+            }
+            await this.sendJsonResponse(res, httpStatus, response);
+            this.logger.info('Embedding migration request completed', {
+                requestId,
+                success: response.success,
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error('Embedding migration request failed', error instanceof Error ? error : new Error(String(error)), { requestId });
+            await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'MIGRATION_ERROR', 'Failed to process embedding migration request', { error: errorMessage });
+        }
+    }
     /**
      * Set CORS headers
      */
@@ -1632,13 +1759,13 @@ class RestApiRouter {
             error: {
                 code,
                 message,
-                details
+                details,
             },
             meta: {
                 timestamp: new Date().toISOString(),
                 requestId,
-                version: this.config.version
-            }
+                version: this.config.version,
+            },
         };
         await this.sendJsonResponse(res, status, response);
     }