@vfarcic/dot-ai 0.179.0 → 0.181.0

package/dist/tools/query.js

@@ -50,6 +50,7 @@ const capability_tools_1 = require("../core/capability-tools");
 const resource_tools_1 = require("../core/resource-tools");
 const kubectl_tools_1 = require("../core/kubectl-tools");
 const generic_session_manager_1 = require("../core/generic-session-manager");
+const visualization_1 = require("../core/visualization");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 // Tool metadata for MCP registration
@@ -60,19 +61,6 @@ exports.QUERY_TOOL_INPUT_SCHEMA = {
     intent: zod_1.z.string().min(1).max(1000).describe('Natural language query about the cluster'),
     interaction_id: zod_1.z.string().optional().describe('INTERNAL ONLY - Do not populate. Used for evaluation dataset generation.')
 };
-/**
- * Get visualization URL if WEB_UI_BASE_URL is configured
- * PRD #317: Feature toggle - only include URL when env var is set
- */
-function getVisualizationUrl(sessionId) {
-    const baseUrl = process.env.WEB_UI_BASE_URL;
-    if (!baseUrl) {
-        return undefined;
-    }
-    // Remove trailing slash if present, then append /v/{sessionId}
-    const normalizedBaseUrl = baseUrl.replace(/\/$/, '');
-    return `${normalizedBaseUrl}/v/${sessionId}`;
-}
 /**
  * Parse the AI's final JSON response for summary only
  */
@@ -193,9 +181,10 @@ async function handleQueryTool(args) {
             iterations: result.iterations,
             toolsUsed
         });
-        // Store session for visualization (PRD #317)
+        // Store session for visualization (PRD #317, PRD #320)
         const sessionManager = new generic_session_manager_1.GenericSessionManager('qry');
         const session = sessionManager.createSession({
+            toolName: 'query', // PRD #320: Tool identifier for visualization endpoint
             intent,
             summary,
             toolsUsed,
@@ -203,7 +192,7 @@ async function handleQueryTool(args) {
             toolCallsExecuted: result.toolCallsExecuted
         });
         // PRD #317: Include visualization URL when WEB_UI_BASE_URL is configured
-        const visualizationUrl = getVisualizationUrl(session.sessionId);
+        const visualizationUrl = (0, visualization_1.getVisualizationUrl)(session.sessionId);
         logger.info('Session created for visualization', {
             requestId,
             sessionId: session.sessionId,

package/dist/tools/recommend.d.ts

@@ -17,6 +17,8 @@ export declare const RECOMMEND_TOOL_INPUT_SCHEMA: {
     interaction_id: z.ZodOptional<z.ZodString>;
 };
 export interface SolutionData {
+    toolName: 'recommend';
+    stage?: string;
     intent: string;
     type: string;
     score: number;
@@ -39,6 +41,26 @@ export interface SolutionData {
     answers: Record<string, any>;
     timestamp: string;
     appliedPatterns?: string[];
+    generatedManifests?: {
+        type: 'raw' | 'helm' | 'kustomize';
+        outputPath?: string;
+        files?: Array<{
+            relativePath: string;
+            content: string;
+        }>;
+        valuesYaml?: string;
+        helmCommand?: string;
+        chart?: {
+            repository: string;
+            repositoryName: string;
+            chartName: string;
+            version: string;
+        };
+        releaseName?: string;
+        namespace?: string;
+        validationAttempts?: number;
+        packagingAttempts?: number;
+    };
 }
 /**
  * Direct MCP tool handler for recommend functionality (unified with stage routing)

package/dist/tools/recommend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recommend.d.ts","sourceRoot":"","sources":["../../src/tools/recommend.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAUhD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMnD,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAC/C,eAAO,MAAM,0BAA0B,yXAAyX,CAAC;AAGja,eAAO,MAAM,2BAA2B;;;;;;;;CAWvC,CAAC;AAIF,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IAEH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE;QACT,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;QACjB,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC;QACd,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC7B,CAAC;IACF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAiCD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,GAAG,EACT,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC,CAkVxD"}
+{"version":3,"file":"recommend.d.ts","sourceRoot":"","sources":["../../src/tools/recommend.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAWhD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMnD,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAC/C,eAAO,MAAM,0BAA0B,yXAAyX,CAAC;AAGja,eAAO,MAAM,2BAA2B;;;;;;;;CAWvC,CAAC;AAIF,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IAEH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE;QACT,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;QACjB,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC;QACd,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC7B,CAAC;IACF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B,kBAAkB,CAAC,EAAE;QACnB,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,WAAW,CAAC;QACnC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,KAAK,CAAC;YAAE,YAAY,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACzD,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE;YACN,UAAU,EAAE,MAAM,CAAC;YACnB,cAAc,EAAE,MAAM,CAAC;YACvB,SAAS,EAAE,MAAM,CAAC;YAClB,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;QACF,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAiCD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,GAAG,EACT,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC,CA+WxD"}

package/dist/tools/recommend.js

@@ -16,6 +16,7 @@ const generate_manifests_1 = require("./generate-manifests");
 const deploy_manifests_1 = require("./deploy-manifests");
 const shared_prompt_loader_1 = require("../core/shared-prompt-loader");
 const platform_utils_1 = require("../core/platform-utils");
+const visualization_1 = require("../core/visualization");
 const artifacthub_1 = require("../core/artifacthub");
 // Intent refinement heuristic constants
 const VAGUE_INTENT_THRESHOLD = 100; // Characters - intents below this trigger guidance
@@ -202,6 +203,7 @@ async function handleRecommendTool(args, dotAI, logger, requestId) {
                 // Find the original chart data from ArtifactHub results
                 const originalChart = charts.find(c => c.name === aiSolution.chartName);
                 const solutionData = {
+                    toolName: 'recommend',
                     intent: args.intent,
                     type: 'helm',
                     score: aiSolution.score,
@@ -232,6 +234,9 @@ async function handleRecommendTool(args, dotAI, logger, requestId) {
                     reasons: aiSolution.reasons
                 });
             }
+            // PRD #320: Generate visualization URL with all solution session IDs
+            const helmSessionIds = helmSolutionSummaries.map(s => s.solutionId);
+            const helmVisualizationUrl = (0, visualization_1.getVisualizationUrl)(helmSessionIds);
             // Build Helm solutions response
             const helmResponse = {
                 intent: args.intent,
@@ -239,19 +244,27 @@ async function handleRecommendTool(args, dotAI, logger, requestId) {
                 helmInstallation: true,
                 nextAction: 'Call recommend tool with stage: chooseSolution and your preferred solutionId',
                 guidance: '🔴 CRITICAL: Present these Helm chart options to the user and ask them to choose. DO NOT automatically call chooseSolution() without user input. Show the chart details (repository, version, official status) to help users decide.',
-                timestamp
+                timestamp,
+                ...(helmVisualizationUrl && { visualizationUrl: helmVisualizationUrl })
             };
             logger.info('Helm solutions prepared', {
                 requestId,
                 solutionCount: helmSolutionSummaries.length,
-                topScore: helmSolutionSummaries[0]?.score
+                topScore: helmSolutionSummaries[0]?.score,
+                ...(helmVisualizationUrl && { visualizationUrl: helmVisualizationUrl })
             });
-            return {
-                content: [{
-                        type: 'text',
-                        text: JSON.stringify(helmResponse, null, 2)
-                    }]
-            };
+            // PRD #320: Return two content blocks - JSON for REST API, text instruction for MCP agents
+            const content = [{
+                    type: 'text',
+                    text: JSON.stringify(helmResponse, null, 2)
+                }];
+            if (helmVisualizationUrl) {
+                content.push({
+                    type: 'text',
+                    text: `📊 **View visualization**: ${helmVisualizationUrl}`
+                });
+            }
+            return { content };
         }
         const solutions = solutionResult.solutions;
         logger.info('Recommendation process completed', {
@@ -267,6 +280,7 @@ async function handleRecommendTool(args, dotAI, logger, requestId) {
         for (const solution of topSolutions) {
             // Create complete solution data
             const solutionData = {
+                toolName: 'recommend',
                 intent: args.intent,
                 type: solution.type,
                 score: solution.score,
@@ -309,6 +323,9 @@ async function handleRecommendTool(args, dotAI, logger, requestId) {
         const patternsUsedCount = solutionSummaries.filter(s => s.appliedPatterns && s.appliedPatterns.length > 0).length;
         const totalPatterns = solutionSummaries.reduce((count, s) => count + (s.appliedPatterns?.length || 0), 0);
         const totalPolicies = solutionSummaries.reduce((count, s) => count + (s.relevantPolicies?.length || 0), 0);
+        // PRD #320: Generate visualization URL with all solution session IDs
+        const sessionIds = solutionSummaries.map(s => s.solutionId);
+        const visualizationUrl = (0, visualization_1.getVisualizationUrl)(sessionIds);
         // Build new response format
         const response = {
             intent: args.intent,
@@ -323,18 +340,26 @@ async function handleRecommendTool(args, dotAI, logger, requestId) {
             },
             nextAction: "Call recommend tool with stage: chooseSolution and your preferred solutionId",
             guidance: "🔴 CRITICAL: You MUST present these solutions to the user and ask them to choose. DO NOT automatically call chooseSolution() without user input. Stop here and wait for user selection. IMPORTANT: Show the list of Kubernetes resources (from the 'resources' field) that each solution will use - this helps users understand what gets deployed. ALSO: Include pattern usage information in your response - show which solutions used organizational patterns and which did not.",
-            timestamp
+            timestamp,
+            ...(visualizationUrl && { visualizationUrl })
         };
         logger.info('Solution sessions created and response prepared', {
             requestId,
-            solutionCount: solutionSummaries.length
+            solutionCount: solutionSummaries.length,
+            ...(visualizationUrl && { visualizationUrl })
         });
-        return {
-            content: [{
-                    type: 'text',
-                    text: JSON.stringify(response, null, 2)
-                }]
-        };
+        // PRD #320: Return two content blocks - JSON for REST API, text instruction for MCP agents
+        const content = [{
+                type: 'text',
+                text: JSON.stringify(response, null, 2)
+            }];
+        if (visualizationUrl) {
+            content.push({
+                type: 'text',
+                text: `📊 **View visualization**: ${visualizationUrl}`
+            });
+        }
+        return { content };
     }, {
         operation: 'recommend_tool',
         component: 'RecommendTool',

package/dist/tools/remediate.d.ts

@@ -2,6 +2,7 @@
  * Remediate Tool - AI-powered Kubernetes issue analysis and remediation
  */
 import { z } from 'zod';
+import { BaseVisualizationData } from '../core/visualization';
 export declare const REMEDIATE_TOOL_NAME = "remediate";
 export declare const REMEDIATE_TOOL_DESCRIPTION = "AI-powered Kubernetes issue analysis that provides root cause identification and actionable remediation steps. Unlike basic kubectl commands, this tool performs multi-step investigation, correlates cluster data, and generates intelligent solutions. Use when users want to understand WHY something is broken, not just see raw status. Ideal for: troubleshooting failures, diagnosing performance issues, analyzing pod problems, investigating networking/storage issues, or any \"what's wrong\" questions.";
 export declare const REMEDIATE_TOOL_INPUT_SCHEMA: {
@@ -31,7 +32,8 @@ export interface RemediateInput {
     executedCommands?: string[];
     interaction_id?: string;
 }
-export interface RemediateSessionData {
+export interface RemediateSessionData extends BaseVisualizationData {
+    toolName: 'remediate';
     issue: string;
     mode: 'manual' | 'automatic';
     interaction_id?: string;

package/dist/tools/remediate.d.ts.map

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

package/dist/tools/remediate.js

@@ -45,6 +45,7 @@ const ai_provider_factory_1 = require("../core/ai-provider-factory");
 const generic_session_manager_1 = require("../core/generic-session-manager");
 const kubectl_tools_1 = require("../core/kubectl-tools");
 const index_1 = require("../core/index");
+const visualization_1 = require("../core/visualization");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 // PRD #143 Milestone 1: Hybrid approach - AI can use kubectl_api_resources tool OR continue with JSON dataRequests
@@ -596,7 +597,9 @@ async function handleRemediateTool(args) {
             throw error_handling_1.ErrorHandler.createError(error_handling_1.ErrorCategory.VALIDATION, error_handling_1.ErrorSeverity.HIGH, 'Issue description is required for new investigations', { operation: 'input_validation', component: 'RemediateTool' });
         }
         // Create initial session using session manager
+        // PRD #320: Include toolName for visualization prompt selection
         const session = sessionManager.createSession({
+            toolName: 'remediate',
             issue: validatedInput.issue,
             mode: validatedInput.mode || 'manual',
             interaction_id: validatedInput.interaction_id,
@@ -622,14 +625,22 @@ async function handleRemediateTool(args) {
                 sessionId: session.sessionId,
                 status: finalAnalysis.status
             });
-            // Return MCP-compliant response for resolved issues
+            // PRD #320: Generate visualization URL for resolved issues
+            const visualizationUrl = (0, visualization_1.getVisualizationUrl)(session.sessionId);
+            // PRD #320: Append visualization URL to message so agents display it to users
+            const messageWithVisualization = visualizationUrl
+                ? `${finalAnalysis.message}\n\n📊 View visualization: ${visualizationUrl}`
+                : finalAnalysis.message;
+            // PRD #320: Return JSON with visualization URL in message (for agents) and visualizationUrl field (for REST API)
             return {
-                content: [
-                    {
+                content: [{
                         type: 'text',
-                        text: JSON.stringify(finalAnalysis, null, 2)
-                    }
-                ]
+                        text: JSON.stringify({
+                            ...finalAnalysis,
+                            message: messageWithVisualization,
+                            ...(visualizationUrl && { visualizationUrl })
+                        }, null, 2)
+                    }]
             };
         }
         // Make execution decision based on mode and thresholds
@@ -673,14 +684,22 @@ async function handleRemediateTool(args) {
             // Execute commands and return the complete result (includes post-execution validation)
             return await executeRemediationCommands(session, sessionManager, logger, requestId, validatedInput.interaction_id);
         }
-        // Return MCP-compliant response
+        // PRD #320: Generate visualization URL for analysis response
+        const visualizationUrl = (0, visualization_1.getVisualizationUrl)(session.sessionId);
+        // PRD #320: Append visualization URL to message so agents display it to users
+        const messageWithVisualization = visualizationUrl
+            ? `${finalResult.message}\n\n📊 View visualization: ${visualizationUrl}`
+            : finalResult.message;
+        // PRD #320: Return JSON with visualization URL in message (for agents) and visualizationUrl field (for REST API)
         return {
-            content: [
-                {
+            content: [{
                     type: 'text',
-                    text: JSON.stringify(finalResult, null, 2)
-                }
-            ]
+                    text: JSON.stringify({
+                        ...finalResult,
+                        message: messageWithVisualization,
+                        ...(visualizationUrl && { visualizationUrl })
+                    }, null, 2)
+                }]
         };
     }
     catch (error) {

package/dist/tools/version.d.ts

@@ -6,6 +6,7 @@
  */
 import { z } from 'zod';
 import { Logger } from '../core/error-handling';
+import { BaseVisualizationData } from '../core/visualization';
 export declare const VERSION_TOOL_NAME = "version";
 export declare const VERSION_TOOL_DESCRIPTION = "Get comprehensive system health and diagnostics";
 export declare const VERSION_TOOL_INPUT_SCHEMA: {
@@ -91,6 +92,21 @@ export interface SystemStatus {
         initialized: boolean;
     };
 }
+export interface VersionSessionData extends BaseVisualizationData {
+    toolName: 'version';
+    system: SystemStatus;
+    summary: {
+        overall: 'healthy' | 'degraded';
+        patternSearch: string;
+        capabilityScanning: string;
+        kubernetesAccess: string;
+        policyIntentManagement: string;
+        kyvernoPolicyGeneration: string;
+        capabilities: string[];
+    };
+    timestamp: string;
+    status: 'success' | 'error';
+}
 /**
  * Test Kyverno installation and readiness for policy generation using shared client
  */

package/dist/tools/version.d.ts.map

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

package/dist/tools/version.js

@@ -53,6 +53,8 @@ const discovery_1 = require("../core/discovery");
 const kubernetes_utils_1 = require("../core/kubernetes-utils");
 const tracing_1 = require("../core/tracing");
 const config_1 = require("../core/tracing/config");
+const generic_session_manager_1 = require("../core/generic-session-manager");
+const visualization_1 = require("../core/visualization");
 exports.VERSION_TOOL_NAME = 'version';
 exports.VERSION_TOOL_DESCRIPTION = 'Get comprehensive system health and diagnostics';
 exports.VERSION_TOOL_INPUT_SCHEMA = {
@@ -603,36 +605,60 @@ async function handleVersionTool(args, logger, requestId) {
         });
         // Check if we should show feedback message
         const feedbackMessage = (0, index_1.maybeGetFeedbackMessage)();
-        return {
-            content: [{
-                    type: 'text',
-                    text: JSON.stringify({
-                        status: 'success',
-                        system: systemStatus,
-                        summary: {
-                            overall: vectorDBStatus.connected && aiProviderStatus.connected && kubernetesStatus.connected && capabilityStatus.systemReady ? 'healthy' : 'degraded',
-                            patternSearch: embeddingStatus.available ? 'semantic+keyword' : 'keyword-only',
-                            capabilityScanning: capabilityStatus.systemReady && kubernetesStatus.connected ? 'ready' : 'not-ready',
-                            kubernetesAccess: kubernetesStatus.connected ? 'connected' : 'disconnected',
-                            policyIntentManagement: vectorDBStatus.connected && embeddingStatus.available ? 'ready' : 'not-ready',
-                            kyvernoPolicyGeneration: kyvernoStatus.policyGenerationReady ? 'ready' : 'not-ready',
-                            capabilities: [
-                                vectorDBStatus.connected && vectorDBStatus.collections.patterns.exists ? 'pattern-management' : null,
-                                // Policy intent management is available if Vector DB and embedding service are ready
-                                vectorDBStatus.connected && embeddingStatus.available ? 'policy-intent-management' : null,
-                                capabilityStatus.systemReady && kubernetesStatus.connected ? 'capability-scanning' : null,
-                                embeddingStatus.available ? 'semantic-search' : null,
-                                aiProviderStatus.connected ? 'ai-recommendations' : null,
-                                kubernetesStatus.connected ? 'kubernetes-integration' : null,
-                                // Kyverno policy generation is only available when Kyverno is installed
-                                kyvernoStatus.policyGenerationReady ? 'kyverno-policy-generation' : null
-                            ].filter(Boolean)
-                        },
-                        timestamp: new Date().toISOString(),
-                        ...(feedbackMessage ? { message: feedbackMessage } : {})
-                    }, null, 2)
-                }]
+        // Build summary object
+        const summary = {
+            overall: (vectorDBStatus.connected && aiProviderStatus.connected && kubernetesStatus.connected && capabilityStatus.systemReady ? 'healthy' : 'degraded'),
+            patternSearch: embeddingStatus.available ? 'semantic+keyword' : 'keyword-only',
+            capabilityScanning: capabilityStatus.systemReady && kubernetesStatus.connected ? 'ready' : 'not-ready',
+            kubernetesAccess: kubernetesStatus.connected ? 'connected' : 'disconnected',
+            policyIntentManagement: vectorDBStatus.connected && embeddingStatus.available ? 'ready' : 'not-ready',
+            kyvernoPolicyGeneration: kyvernoStatus.policyGenerationReady ? 'ready' : 'not-ready',
+            capabilities: [
+                vectorDBStatus.connected && vectorDBStatus.collections.patterns.exists ? 'pattern-management' : null,
+                // Policy intent management is available if Vector DB and embedding service are ready
+                vectorDBStatus.connected && embeddingStatus.available ? 'policy-intent-management' : null,
+                capabilityStatus.systemReady && kubernetesStatus.connected ? 'capability-scanning' : null,
+                embeddingStatus.available ? 'semantic-search' : null,
+                aiProviderStatus.connected ? 'ai-recommendations' : null,
+                kubernetesStatus.connected ? 'kubernetes-integration' : null,
+                // Kyverno policy generation is only available when Kyverno is installed
+                kyvernoStatus.policyGenerationReady ? 'kyverno-policy-generation' : null
+            ].filter(Boolean)
+        };
+        const timestamp = new Date().toISOString();
+        // PRD #320: Create session for visualization
+        const sessionManager = new generic_session_manager_1.GenericSessionManager('ver');
+        const session = sessionManager.createSession({
+            toolName: 'version',
+            system: systemStatus,
+            summary,
+            timestamp,
+            status: 'success'
+        });
+        // PRD #320: Generate visualization URL if configured
+        const visualizationUrl = (0, visualization_1.getVisualizationUrl)(session.sessionId);
+        // PRD #320: Build response with visualization instruction for agents
+        const responseData = {
+            status: 'success',
+            system: systemStatus,
+            summary,
+            timestamp,
+            ...(feedbackMessage ? { message: feedbackMessage } : {}),
+            ...(visualizationUrl ? { visualizationUrl } : {})
         };
+        // PRD #320: Return two content blocks - JSON for REST API, text instruction for MCP agents
+        const content = [{
+                type: 'text',
+                text: JSON.stringify(responseData, null, 2)
+            }];
+        // Add visualization instruction as second content block so agents display it to users
+        if (visualizationUrl) {
+            content.push({
+                type: 'text',
+                text: `📊 **View visualization**: ${visualizationUrl}`
+            });
+        }
+        return { content };
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vfarcic/dot-ai",
-  "version": "0.179.0",
+  "version": "0.181.0",
   "description": "AI-powered development productivity platform that enhances software development workflows through intelligent automation and AI-driven assistance",
   "mcpName": "io.github.vfarcic/dot-ai",
   "main": "dist/index.js",
@@ -114,6 +114,7 @@
     "@qdrant/js-client-rest": "^1.15.0",
     "ai": "^5.0.60",
     "handlebars": "^4.7.8",
+    "mermaid": "^11.12.2",
     "yaml": "^2.8.0",
     "zod-to-json-schema": "^3.24.6"
   },

package/prompts/visualize.md

@@ -0,0 +1,86 @@
+# Visualization Generator
+
+You are a Kubernetes visualization expert. Analyze the provided data and generate visualizations that reveal valuable insights.
+
+## User Intent
+
+{{{intent}}}
+
+## Data
+
+{{{data}}}
+
+## Your Task
+
+**Start with the provided data**: Analyze this data thoroughly first to create visualizations that surface everything valuable.
+
+If the provided data isn't sufficient for deep analysis, **actively use tools** to gather additional information. Don't just note uncertainties - investigate them.
+
+## Output Format
+
+Respond with ONLY a JSON object (no markdown code fences, no extra text):
+
+{
+  "title": "Descriptive title based on what was found",
+  "visualizations": [...],
+  "insights": [...]
+}
+
+## Visualization Types
+
+Generate as many or as few visualizations as add value. You can:
+- Include multiple visualizations of the same type
+- Skip any type entirely if it doesn't add value for this data
+- Use whatever combination best represents what you found
+
+Each visualization:
+```
+{
+  "id": "unique-id",
+  "label": "Tab Label",
+  "type": "mermaid" | "table" | "cards" | "code",
+  "content": <type-specific-content>
+}
+```
+
+### mermaid
+- `content`: Valid Mermaid diagram string
+- Use `graph TD` or `graph LR` depending on relationship type
+- Use subgraphs to group related items
+- Arrows: `-->` for direct relationships, `-.->` for indirect/inferred
+- **Syntax rules**:
+  - Node names in `class` statements MUST be comma-separated: `class a,b,c style` (not space-separated)
+  - If using `classDef`, ALWAYS specify both `fill` AND `color` (text) with sufficient contrast
+  - Truncate UUIDs to first 8 characters (e.g., `pvc-508555a4...`)
+  - Keep node labels under 30 characters when possible
+
+### table
+- `content`: `{ "headers": ["Col1", "Col2"], "rows": [["val1", "val2"]] }`
+- Choose columns relevant to the data present
+- Include status/condition information when available
+
+### cards
+- `content`: `[{ "id": "unique", "title": "Name", "subtitle": "Type or status", "description": "Details", "tags": ["tag1"] }]`
+- Use for items where individual status or comparison matters
+- Tags should reflect actual state from the data
+
+### code
+- `content`: `{ "language": "yaml" | "json" | "bash", "code": "..." }`
+- Use sparingly - only when raw output adds value
+
+## Insights
+
+Generate insights that add value beyond what someone could see by just reading the raw data. Prioritize non-obvious findings over summaries.
+
+Each insight should:
+- Reference specific items from the data
+- Explain WHY it matters, not just WHAT you found
+- Be actionable when highlighting issues
+
+## Rules
+
+1. **Data-driven only** - Base visualizations on actual data present
+2. **Skip empty visualizations** - Don't include visualizations with no meaningful content
+3. **Valid output** - Ensure Mermaid syntax is correct and JSON is valid
+4. **JSON only** - No markdown fences, no explanations outside the JSON structure
+5. **Use validate_mermaid** - Before returning any Mermaid diagrams, validate them using the validate_mermaid tool