@vfarcic/dot-ai 0.138.0 → 0.140.0

package/dist/tools/operate-execution.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * Operate Execution Workflow
+ *
+ * Executes approved operational changes using shared command executor
+ * and validates results using remediate tool
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeOperations = executeOperations;
+const error_handling_1 = require("../core/error-handling");
+const command_executor_1 = require("../core/command-executor");
+const remediate_1 = require("./remediate");
+/**
+ * Executes approved operational changes
+ * @param sessionId - Session ID with approved changes
+ * @param logger - Logger instance
+ * @param sessionManager - Session manager instance
+ * @returns Operation output with execution results
+ */
+async function executeOperations(sessionId, logger, sessionManager) {
+    logger.info('Starting operation execution', { sessionId });
+    try {
+        // 1. Load session with approved commands
+        const session = sessionManager.getSession(sessionId);
+        if (!session) {
+            throw error_handling_1.ErrorHandler.createError(error_handling_1.ErrorCategory.VALIDATION, error_handling_1.ErrorSeverity.HIGH, `Session not found: ${sessionId}. The session may have expired or been deleted.`, { operation: 'session_loading', component: 'OperateExecutionTool' });
+        }
+        // Check if already executed
+        if (session.data.status === 'executing' || session.data.status === 'executed_successfully' || session.data.status === 'executed_with_errors') {
+            throw error_handling_1.ErrorHandler.createError(error_handling_1.ErrorCategory.VALIDATION, error_handling_1.ErrorSeverity.MEDIUM, `Session ${sessionId} has already been executed. Current status: ${session.data.status}`, { operation: 'execution_validation', component: 'OperateExecutionTool' });
+        }
+        // Update session status to executing
+        sessionManager.updateSession(sessionId, { status: 'executing' });
+        logger.info('Loaded session for execution', {
+            sessionId,
+            commandCount: session.data.commands.length,
+            intent: session.data.intent
+        });
+        // 2. Execute commands using shared executor
+        const { results, overallSuccess } = await (0, command_executor_1.executeCommands)(session.data.commands, logger, {
+            sessionId,
+            context: 'operation',
+            logMetadata: { intent: session.data.intent }
+        });
+        // Convert CommandExecutionResult to ExecutionResult
+        const executionResults = results.map(r => ({
+            command: r.command,
+            success: r.success,
+            output: r.output,
+            error: r.error,
+            timestamp: r.timestamp
+        }));
+        // 3. Run validation via remediate tool (only if commands succeeded)
+        let validationSummary = 'Validation skipped due to command failures.';
+        if (overallSuccess && session.data.validationIntent) {
+            logger.info('Running post-execution validation via remediate', {
+                sessionId,
+                validationIntent: session.data.validationIntent
+            });
+            try {
+                // Call remediate tool internally with validation intent
+                const validationResponse = await (0, remediate_1.handleRemediateTool)({
+                    issue: session.data.validationIntent,
+                    executedCommands: session.data.commands,
+                    interaction_id: session.data.interaction_id
+                });
+                // Extract validation result from remediate response
+                const validationData = JSON.parse(validationResponse.content[0].text);
+                if (validationData.status === 'resolved' || validationData.status === 'no_issue_found') {
+                    validationSummary = `Validation successful: ${validationData.message || 'Operations completed as expected.'}`;
+                }
+                else {
+                    validationSummary = `Validation completed with confidence ${Math.round((validationData.analysis?.confidence || 0) * 100)}%: ${validationData.analysis?.rootCause || 'See validation details'}`;
+                }
+                logger.info('Validation completed', { sessionId, validationSummary });
+            }
+            catch (error) {
+                logger.error('Validation failed', error, { sessionId });
+                validationSummary = `Validation encountered an error: ${error instanceof Error ? error.message : 'Unknown error'}. Manual verification recommended.`;
+            }
+        }
+        // 4. Update session with execution results
+        const finalStatus = overallSuccess ? 'executed_successfully' : 'executed_with_errors';
+        sessionManager.updateSession(sessionId, {
+            status: finalStatus,
+            executionResults
+        });
+        logger.info('Execution completed', {
+            sessionId,
+            finalStatus,
+            successCount: executionResults.filter(r => r.success).length,
+            failureCount: executionResults.filter(r => !r.success).length
+        });
+        // 5. Return execution results with validation
+        return {
+            status: overallSuccess ? 'success' : 'failed',
+            sessionId,
+            execution: {
+                results: executionResults,
+                validation: validationSummary
+            },
+            message: overallSuccess
+                ? `All ${executionResults.length} command(s) executed successfully. ${validationSummary}`
+                : `${executionResults.filter(r => !r.success).length} of ${executionResults.length} command(s) failed. See execution results for details.`
+        };
+    }
+    catch (error) {
+        logger.error('Execution failed', error, { sessionId });
+        // Mark session as failed if we can
+        try {
+            sessionManager.updateSession(sessionId, { status: 'failed' });
+        }
+        catch (updateError) {
+            // Ignore - session might not exist
+        }
+        throw error_handling_1.ErrorHandler.createError(error_handling_1.ErrorCategory.OPERATION, error_handling_1.ErrorSeverity.HIGH, `Execution failed: ${error instanceof Error ? error.message : 'Unknown error'}`, {
+            operation: 'execute_operations',
+            component: 'OperateExecutionTool',
+            sessionId
+        });
+    }
+}

package/dist/tools/operate.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Operate Tool - AI-powered Kubernetes application operations
+ */
+import { z } from 'zod';
+import { Logger } from '../core/error-handling';
+import { OrganizationalPattern, PolicyIntent } from '../core/organizational-types';
+import { ResourceCapability } from '../core/capabilities';
+export declare const OPERATE_TOOL_NAME = "operate";
+export declare const OPERATE_TOOL_DESCRIPTION = "AI-powered Kubernetes application operations tool for Day 2 operations. Handles updates, scaling, enhancements, rollbacks, and deletions through natural language intents. Analyzes current state, applies organizational patterns and policies, validates changes via dry-run, and executes approved operations safely.";
+export declare const OPERATE_TOOL_INPUT_SCHEMA: {
+    intent: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    executeChoice: z.ZodOptional<z.ZodNumber>;
+    refinedIntent: z.ZodOptional<z.ZodString>;
+    interaction_id: z.ZodOptional<z.ZodString>;
+};
+export interface OperateInput {
+    intent?: string;
+    sessionId?: string;
+    executeChoice?: number;
+    refinedIntent?: string;
+    interaction_id?: string;
+}
+export interface OperateSessionData {
+    intent: string;
+    interaction_id?: string;
+    context: EmbeddedContext;
+    proposedChanges: ProposedChanges;
+    commands: string[];
+    dryRunValidation: {
+        status: 'success' | 'failed';
+        details: string;
+    };
+    patternsApplied: string[];
+    capabilitiesUsed: string[];
+    policiesChecked: string[];
+    risks: {
+        level: 'low' | 'medium' | 'high';
+        description: string;
+    };
+    validationIntent: string;
+    status: 'analyzing' | 'analysis_complete' | 'executing' | 'executed_successfully' | 'executed_with_errors' | 'failed';
+    executionResults?: ExecutionResult[];
+}
+export type OperateSession = {
+    sessionId: string;
+    createdAt: string;
+    updatedAt: string;
+    data: OperateSessionData;
+};
+export interface EmbeddedContext {
+    patterns: OrganizationalPattern[];
+    policies: PolicyIntent[];
+    capabilities: ResourceCapability[];
+}
+export interface ProposedChanges {
+    create: ResourceChange[];
+    update: ResourceChange[];
+    delete: ResourceChange[];
+}
+export interface ResourceChange {
+    kind: string;
+    name: string;
+    namespace?: string;
+    manifest?: string;
+    changes?: string;
+    rationale: string;
+}
+export interface ExecutionResult {
+    command: string;
+    success: boolean;
+    output?: string;
+    error?: string;
+    timestamp: Date;
+}
+export interface OperateOutput {
+    status: 'success' | 'failed' | 'awaiting_user_approval';
+    sessionId: string;
+    analysis?: {
+        summary: string;
+        currentState: any;
+        proposedChanges: ProposedChanges;
+        commands: string[];
+        dryRunValidation: {
+            status: 'success' | 'failed';
+            details: string;
+        };
+        patternsApplied: string[];
+        capabilitiesUsed: string[];
+        policiesChecked: string[];
+        risks: {
+            level: 'low' | 'medium' | 'high';
+            description: string;
+        };
+        validationIntent: string;
+    };
+    execution?: {
+        results: ExecutionResult[];
+        validation: string;
+    };
+    message: string;
+    nextAction?: string;
+}
+/**
+ * Embed context (patterns, policies, capabilities) for AI analysis
+ * @param intent User's operational intent
+ * @returns Embedded context with patterns, policies, and capabilities
+ * @throws Error if capabilities are not available (mandatory)
+ */
+export declare function embedContext(intent: string, logger: Logger): Promise<EmbeddedContext>;
+/**
+ * Format patterns for template placeholder
+ */
+export declare function formatPatterns(patterns: OrganizationalPattern[]): string;
+/**
+ * Format policies for template placeholder
+ */
+export declare function formatPolicies(policies: PolicyIntent[]): string;
+/**
+ * Format capabilities for template placeholder
+ * Capabilities are already ordered by relevance from vector search
+ */
+export declare function formatCapabilities(capabilities: ResourceCapability[]): string;
+/**
+ * Main operate tool entry point
+ */
+export declare function operate(args: OperateInput): Promise<OperateOutput>;
+/**
+ * MCP handler for operate tool
+ * Wraps the main operate function with consistent return format
+ */
+export declare function handleOperateTool(args: any): Promise<any>;
+//# sourceMappingURL=operate.d.ts.map

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

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

package/dist/tools/operate.js

@@ -0,0 +1,237 @@
+"use strict";
+/**
+ * Operate Tool - AI-powered Kubernetes application operations
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPERATE_TOOL_INPUT_SCHEMA = exports.OPERATE_TOOL_DESCRIPTION = exports.OPERATE_TOOL_NAME = void 0;
+exports.embedContext = embedContext;
+exports.formatPatterns = formatPatterns;
+exports.formatPolicies = formatPolicies;
+exports.formatCapabilities = formatCapabilities;
+exports.operate = operate;
+exports.handleOperateTool = handleOperateTool;
+const zod_1 = require("zod");
+const error_handling_1 = require("../core/error-handling");
+const generic_session_manager_1 = require("../core/generic-session-manager");
+const pattern_vector_service_1 = require("../core/pattern-vector-service");
+const policy_vector_service_1 = require("../core/policy-vector-service");
+const capability_vector_service_1 = require("../core/capability-vector-service");
+// Tool metadata for direct MCP registration
+exports.OPERATE_TOOL_NAME = 'operate';
+exports.OPERATE_TOOL_DESCRIPTION = 'AI-powered Kubernetes application operations tool for Day 2 operations. Handles updates, scaling, enhancements, rollbacks, and deletions through natural language intents. Analyzes current state, applies organizational patterns and policies, validates changes via dry-run, and executes approved operations safely.';
+// Zod schema for MCP registration
+exports.OPERATE_TOOL_INPUT_SCHEMA = {
+    intent: zod_1.z.string().min(1).max(2000).optional().describe('User intent for operation: "update X to Y", "scale Z", "make W HA", etc.'),
+    sessionId: zod_1.z.string().optional().describe('Session ID from previous operate call'),
+    executeChoice: zod_1.z.number().min(1).max(1).optional().describe('Execute approved changes (1=execute)'),
+    refinedIntent: zod_1.z.string().min(1).max(2000).optional().describe('Clarified intent if user wants to provide more details'),
+    interaction_id: zod_1.z.string().optional().describe('INTERNAL ONLY - Do not populate. Used for evaluation dataset generation.')
+};
+// Session manager instance
+const sessionManager = new generic_session_manager_1.GenericSessionManager('opr');
+// Initialize logger
+const logger = new error_handling_1.ConsoleLogger('OperateTool');
+/**
+ * Embed context (patterns, policies, capabilities) for AI analysis
+ * @param intent User's operational intent
+ * @returns Embedded context with patterns, policies, and capabilities
+ * @throws Error if capabilities are not available (mandatory)
+ */
+async function embedContext(intent, logger) {
+    const context = {
+        patterns: [],
+        policies: [],
+        capabilities: []
+    };
+    // Search for relevant patterns (optional - non-blocking)
+    try {
+        const patternService = new pattern_vector_service_1.PatternVectorService();
+        const patternResults = await patternService.searchPatterns(intent, { limit: 5 });
+        context.patterns = patternResults.map(result => result.data);
+        logger.info(`Found ${context.patterns.length} relevant organizational patterns`);
+    }
+    catch (error) {
+        logger.warn('Pattern search failed, continuing without patterns', { error });
+    }
+    // Search for relevant policies (optional - non-blocking)
+    try {
+        const policyService = new policy_vector_service_1.PolicyVectorService();
+        const policyResults = await policyService.searchPolicyIntents(intent, { limit: 5 });
+        context.policies = policyResults.map(result => result.data);
+        logger.info(`Found ${context.policies.length} relevant organizational policies`);
+    }
+    catch (error) {
+        logger.warn('Policy search failed, continuing without policies', { error });
+    }
+    // Search for relevant cluster capabilities (MANDATORY)
+    try {
+        // Use QDRANT_CAPABILITIES_COLLECTION env var for collection name
+        // Integration tests set this to 'capabilities-policies' (pre-populated test data)
+        // Production uses default 'capabilities' collection
+        const collectionName = process.env.QDRANT_CAPABILITIES_COLLECTION || 'capabilities';
+        const capabilityService = new capability_vector_service_1.CapabilityVectorService(collectionName);
+        const capabilityResults = await capabilityService.searchCapabilities(intent, { limit: 50 });
+        if (capabilityResults.length === 0) {
+            throw new Error(`No cluster capabilities found for intent "${intent}". Please scan your cluster first:\n` +
+                `Run: manageOrgData({ dataType: "capabilities", operation: "scan" })\n` +
+                `Note: Capabilities are required to understand what resources and operators are available in the cluster.`);
+        }
+        context.capabilities = capabilityResults.map(result => result.data);
+        logger.info(`Found ${context.capabilities.length} relevant cluster capabilities`);
+    }
+    catch (error) {
+        // If it's our specific "no capabilities" error, re-throw it
+        if (error instanceof Error && error.message.includes('No cluster capabilities found')) {
+            throw error;
+        }
+        // Otherwise, it's a capability service initialization or retrieval error
+        throw new Error(`Capability service not available for intent "${intent}". Please scan your cluster first:\n` +
+            `Run: manageOrgData({ dataType: "capabilities", operation: "scan" })\n` +
+            `Note: Vector DB is required for capability-based operations.\n` +
+            `Error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return context;
+}
+/**
+ * Format patterns for template placeholder
+ */
+function formatPatterns(patterns) {
+    if (patterns.length === 0) {
+        return 'No organizational patterns found matching this intent.';
+    }
+    let formatted = '';
+    patterns.forEach((pattern, index) => {
+        formatted += `### Pattern ${index + 1}: ${pattern.description}\n\n`;
+        formatted += `**Triggers:** ${pattern.triggers.join(', ')}\n\n`;
+        formatted += `**Suggested Resources:** ${pattern.suggestedResources.join(', ')}\n\n`;
+        formatted += `**Rationale:** ${pattern.rationale}\n\n`;
+        if (index < patterns.length - 1) {
+            formatted += '---\n\n';
+        }
+    });
+    return formatted;
+}
+/**
+ * Format policies for template placeholder
+ */
+function formatPolicies(policies) {
+    if (policies.length === 0) {
+        return 'No organizational policies found matching this intent.';
+    }
+    let formatted = '';
+    policies.forEach((policy, index) => {
+        formatted += `### Policy ${index + 1}: ${policy.description}\n\n`;
+        if (policy.triggers && policy.triggers.length > 0) {
+            formatted += `**Applies to:** ${policy.triggers.join(', ')}\n\n`;
+        }
+        formatted += `**Rationale:** ${policy.rationale}\n\n`;
+        if (index < policies.length - 1) {
+            formatted += '---\n\n';
+        }
+    });
+    return formatted;
+}
+/**
+ * Format capabilities for template placeholder
+ * Capabilities are already ordered by relevance from vector search
+ */
+function formatCapabilities(capabilities) {
+    if (capabilities.length === 0) {
+        return 'No custom capabilities detected. Only standard Kubernetes resources available.';
+    }
+    // List capabilities in order received (most relevant first from vector search)
+    let formatted = '';
+    capabilities.forEach(cap => {
+        const apiInfo = cap.apiVersion || cap.group || 'core';
+        formatted += `- **${cap.resourceName}** (${apiInfo}): ${cap.description || 'Custom resource'}\n`;
+        if (cap.capabilities && cap.capabilities.length > 0) {
+            formatted += `  Capabilities: ${cap.capabilities.join(', ')}\n`;
+        }
+    });
+    return formatted;
+}
+/**
+ * Main operate tool entry point
+ */
+async function operate(args) {
+    try {
+        // Route 1: Execute approved operation
+        if (args.sessionId && args.executeChoice) {
+            // Import and delegate to execution workflow
+            const { executeOperations } = await Promise.resolve().then(() => __importStar(require('./operate-execution')));
+            return await executeOperations(args.sessionId, logger, sessionManager);
+        }
+        // Route 2: Refine intent with more context
+        if (args.sessionId && args.refinedIntent) {
+            // Import and delegate to analysis workflow with refined intent
+            const { analyzeIntent } = await Promise.resolve().then(() => __importStar(require('./operate-analysis')));
+            return await analyzeIntent(args.refinedIntent, logger, sessionManager, args.sessionId, args.interaction_id);
+        }
+        // Route 3: New operation analysis
+        if (args.intent) {
+            // Import and delegate to analysis workflow
+            const { analyzeIntent } = await Promise.resolve().then(() => __importStar(require('./operate-analysis')));
+            return await analyzeIntent(args.intent, logger, sessionManager, undefined, args.interaction_id);
+        }
+        // Invalid input
+        throw error_handling_1.ErrorHandler.createError(error_handling_1.ErrorCategory.VALIDATION, error_handling_1.ErrorSeverity.HIGH, 'Invalid input: must provide either intent (for new operation) or sessionId + executeChoice (for execution)', {
+            operation: 'operate',
+            component: 'OperateTool'
+        });
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        logger.error(`Operate tool error: ${errorMsg}`);
+        return {
+            status: 'failed',
+            sessionId: args.sessionId || 'unknown',
+            message: `Operation failed: ${errorMsg}`
+        };
+    }
+}
+/**
+ * MCP handler for operate tool
+ * Wraps the main operate function with consistent return format
+ */
+async function handleOperateTool(args) {
+    const result = await operate(args);
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(result, null, 2)
+            }]
+    };
+}

package/dist/tools/recommend.d.ts

@@ -5,7 +5,7 @@ import { z } from 'zod';
 import { DotAI } from '../core/index';
 import { Logger } from '../core/error-handling';
 export declare const RECOMMEND_TOOL_NAME = "recommend";
-export declare const RECOMMEND_TOOL_DESCRIPTION = "Deploy, create, setup, install, or run applications, infrastructure, and services on Kubernetes with AI recommendations. Describe what you want to deploy. Does NOT handle policy creation, organizational patterns, or resource capabilities - use manageOrgData for those.";
+export declare const RECOMMEND_TOOL_DESCRIPTION = "Deploy applications, infrastructure, and services using Kubernetes resources with AI recommendations. Supports cloud resources via operators like Crossplane, cluster management via CAPI, and traditional Kubernetes workloads. Describe what you want to deploy. Does NOT handle policy creation, organizational patterns, or resource capabilities - use manageOrgData for those.";
 export declare const RECOMMEND_TOOL_INPUT_SCHEMA: {
     stage: z.ZodOptional<z.ZodString>;
     intent: z.ZodOptional<z.ZodString>;
@@ -15,6 +15,28 @@ export declare const RECOMMEND_TOOL_INPUT_SCHEMA: {
     timeout: z.ZodOptional<z.ZodNumber>;
     interaction_id: z.ZodOptional<z.ZodString>;
 };
+export interface SolutionData {
+    intent: string;
+    type: string;
+    score: number;
+    description: string;
+    reasons: string[];
+    analysis: string;
+    resources: Array<{
+        kind: string;
+        apiVersion: string;
+        group: string;
+        description: string;
+    }>;
+    questions: {
+        required?: any[];
+        basic?: any[];
+        advanced?: any[];
+        open?: any;
+    };
+    answers: Record<string, any>;
+    timestamp: string;
+}
 /**
  * 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;AAIxB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAchD,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAC/C,eAAO,MAAM,0BAA0B,iRAAiR,CAAC;AAGzT,eAAO,MAAM,2BAA2B;;;;;;;;CAWvC,CAAC;AA4GF;;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,CAsRxD"}
+{"version":3,"file":"recommend.d.ts","sourceRoot":"","sources":["../../src/tools/recommend.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAWhD,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAC/C,eAAO,MAAM,0BAA0B,yXAAyX,CAAC;AAGja,eAAO,MAAM,2BAA2B;;;;;;;;CAWvC,CAAC;AAGF,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;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,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;KACZ,CAAC;IACF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAuED;;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,CA4OxD"}