@lagoon-protocol/lagoon-mcp 0.1.0

package/dist/server.js

@@ -0,0 +1,225 @@
+/**
+ * Lagoon MCP Server
+ *
+ * Modern implementation using McpServer API for:
+ * - Automatic capability management
+ * - Clean tool/resource/prompt registration
+ * - Future-proof architecture
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { config } from './config.js';
+import { checkBackendHealth, graphqlClient } from './graphql/client.js';
+// Dependency injection
+import { createContainer } from './core/container.js';
+import { createNodeCacheAdapter } from './core/cache-adapter.js';
+// Tool registry
+import { registerTools } from './tools/registry.js';
+// Resource imports
+import { getGraphQLSchema } from './resources/schema.js';
+import { getDefiGlossary } from './resources/glossary.js';
+// Prompt imports
+import { getFinancialAnalysisPrompt } from './prompts/financial-analysis.js';
+import { getCuratorPerformancePrompt } from './prompts/curator-performance.js';
+import { getCompetitorComparisonPrompt } from './prompts/competitor-comparison.js';
+import { getOnboardingFirstVaultPrompt } from './prompts/onboarding-first-vault.js';
+import { getProtocolOverviewPrompt } from './prompts/protocol-overview.js';
+import { getPortfolioOptimizationPrompt } from './prompts/portfolio-optimization.js';
+/**
+ * Create and configure the MCP server instance
+ *
+ * Uses modern McpServer API for automatic capability management
+ * and clean registration patterns.
+ */
+export function createServer() {
+    const server = new McpServer({
+        name: 'lagoon-mcp',
+        version: '0.1.0',
+    });
+    // ==========================================
+    // Dependency Injection Container
+    // ==========================================
+    // Create service container with all dependencies
+    const container = createContainer(graphqlClient, createNodeCacheAdapter({
+        stdTTL: config.cache.stdTTL,
+        checkperiod: config.cache.checkperiod,
+        maxKeys: config.cache.maxKeys,
+    }), config);
+    // ==========================================
+    // Tool Registration
+    // ==========================================
+    // Register all tools from unified registry with DI container
+    registerTools(server, container);
+    // ==========================================
+    // Resource Registration
+    // ==========================================
+    server.registerResource('graphql-schema', 'lagoon://graphql-schema', {
+        title: 'GraphQL Schema',
+        description: 'Complete GraphQL schema in SDL format. ' +
+            'Includes all types, queries, and mutations for the Lagoon API. ' +
+            'Cached for 24 hours.',
+        mimeType: 'text/plain',
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: 'text/plain',
+                text: await getGraphQLSchema(),
+            },
+        ],
+    }));
+    server.registerResource('defi-glossary', 'lagoon://defi-glossary', {
+        title: 'DeFi Glossary',
+        description: 'Comprehensive terminology guide for Lagoon DeFi Protocol. ' +
+            'Explains vault concepts, financial metrics, transaction types, and calculations. ' +
+            'Essential reference for understanding vault data and analysis.',
+        mimeType: 'text/markdown',
+    }, (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: 'text/markdown',
+                text: getDefiGlossary(),
+            },
+        ],
+    }));
+    // ==========================================
+    // Prompt Registration
+    // ==========================================
+    server.registerPrompt('financial-analysis', {
+        title: 'Financial Analysis',
+        description: 'Guidance for analyzing DeFi vault data and generating financial insights. ' +
+            'Includes analysis patterns for portfolio review, vault performance, and vault discovery. ' +
+            'Provides frameworks for risk assessment, metrics interpretation, and report structure.',
+        argsSchema: {},
+    }, () => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: getFinancialAnalysisPrompt(),
+                },
+            },
+        ],
+    }));
+    server.registerPrompt('curator-performance', {
+        title: 'Curator Performance Intelligence',
+        description: 'Comprehensive framework for evaluating curator performance, reputation, and vault management capabilities. ' +
+            'Includes metrics for weighted APR, Sharpe ratio, consistency analysis, and reputation scoring. ' +
+            'Provides curator selection criteria, trust signals, and monitoring frameworks.',
+        argsSchema: {},
+    }, () => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: getCuratorPerformancePrompt(),
+                },
+            },
+        ],
+    }));
+    server.registerPrompt('competitor-comparison', {
+        title: 'Competitor Comparison Framework',
+        description: 'Objective comparison of Lagoon Protocol against major competitors (Gauntlet, Veda, Ether.fi). ' +
+            'Includes financial performance, platform features, security metrics, and use case recommendations. ' +
+            'Provides scenario-based guidance and migration considerations.',
+        argsSchema: {},
+    }, () => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: getCompetitorComparisonPrompt(),
+                },
+            },
+        ],
+    }));
+    server.registerPrompt('onboarding-first-vault', {
+        title: 'Onboarding: First Vault Selection',
+        description: 'Structured guidance for new users selecting their first vault with confidence-building approach. ' +
+            'Includes 5-step selection process, risk assessment, performance validation, and curator credibility checks. ' +
+            'Provides beginner-friendly decision frameworks and best practices.',
+        argsSchema: {},
+    }, () => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: getOnboardingFirstVaultPrompt(),
+                },
+            },
+        ],
+    }));
+    server.registerPrompt('protocol-overview', {
+        title: 'Protocol Overview & KPI Dashboard',
+        description: 'Real-time protocol health insights and competitive positioning analysis. ' +
+            'Includes TVL trends, vault performance metrics, user growth, ecosystem health, and security assessment. ' +
+            'Provides protocol health scoring and competitive benchmarking.',
+        argsSchema: {},
+    }, () => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: getProtocolOverviewPrompt(),
+                },
+            },
+        ],
+    }));
+    server.registerPrompt('portfolio-optimization', {
+        title: 'Portfolio Optimization Engine',
+        description: 'Modern Portfolio Theory (MPT) based optimization for vault portfolio management. ' +
+            'Includes correlation analysis, efficient frontier calculation, Sharpe ratio optimization, and rebalancing strategies. ' +
+            'Provides risk-return optimization and diversification recommendations.',
+        argsSchema: {},
+    }, () => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: getPortfolioOptimizationPrompt(),
+                },
+            },
+        ],
+    }));
+    return server;
+}
+/**
+ * Run the MCP server
+ */
+export async function runServer() {
+    // Validate configuration
+    console.error('Starting Lagoon MCP Server...');
+    console.error(`GraphQL Endpoint: ${config.graphql.endpoint}`);
+    console.error(`Environment: ${process.env.NODE_ENV || 'development'}`);
+    // Check backend health
+    console.error('Checking backend connection...');
+    try {
+        const isHealthy = await checkBackendHealth();
+        if (isHealthy) {
+            console.error('✓ Backend connection successful');
+        }
+        else {
+            console.error('⚠ Backend health check failed, continuing anyway...');
+        }
+    }
+    catch (error) {
+        console.error('⚠ Cannot reach backend, continuing anyway...');
+        console.error(`  Error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // Create and start server
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    console.error('Connecting to stdio transport...');
+    await server.connect(transport);
+    console.error('✓ Lagoon MCP Server is running');
+    console.error('  Server: McpServer (modern API)');
+    console.error('  Capabilities: Auto-managed');
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/services/analytics/protocol-overview.service.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Protocol Overview Service
+ *
+ * Fetches real-time protocol metrics for dynamic prompt generation.
+ * Provides comprehensive KPI data for protocol health dashboards.
+ */
+import { BaseService } from '../base.service.js';
+/**
+ * Protocol metrics for overview dashboard
+ */
+export interface ProtocolMetrics {
+    totalTVL: number;
+    tvl7dChange: number;
+    tvl30dChange: number;
+    totalVolume24h: number;
+    activeVaults: number;
+    vaultsLast30d: number;
+    avgAPR: number;
+    medianAPR: number;
+    totalUsers: number;
+    activeUsers30d: number;
+    newUsers30d: number;
+    securityIncidents90d: number;
+    avgRiskScore: number;
+    totalCurators: number;
+    activeCurators30d: number;
+    lastUpdated: string;
+}
+/**
+ * Protocol Overview Service
+ * Fetches and aggregates protocol-level metrics
+ */
+export declare class ProtocolOverviewService extends BaseService {
+    private readonly CACHE_KEY;
+    private readonly CACHE_TTL;
+    /**
+     * Fetch protocol metrics with caching
+     */
+    getMetrics(): Promise<ProtocolMetrics>;
+    /**
+     * Fetch protocol metrics from GraphQL
+     */
+    private fetchMetrics;
+    /**
+     * Calculate protocol metrics from GraphQL data
+     */
+    private calculateMetrics;
+    /**
+     * Fallback metrics when GraphQL fails
+     */
+    private getFallbackMetrics;
+    /**
+     * Format TVL with appropriate unit
+     */
+    formatTVL(tvl: number): string;
+    /**
+     * Format percentage change
+     */
+    formatPercentage(value: number): string;
+}
+//# sourceMappingURL=protocol-overview.service.d.ts.map

package/dist/services/analytics/protocol-overview.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-overview.service.d.ts","sourceRoot":"","sources":["../../../src/services/analytics/protocol-overview.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,eAAe;IAE9B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IAGvB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAGlB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IAGpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IAGrB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAG1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,WAAW;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAO;IAEjC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC;IAgB5C;;OAEG;YACW,YAAY;IA4E1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwFxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAU9B;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAIxC"}

package/dist/services/analytics/protocol-overview.service.js

@@ -0,0 +1,182 @@
+/**
+ * Protocol Overview Service
+ *
+ * Fetches real-time protocol metrics for dynamic prompt generation.
+ * Provides comprehensive KPI data for protocol health dashboards.
+ */
+import { BaseService } from '../base.service.js';
+/**
+ * Protocol Overview Service
+ * Fetches and aggregates protocol-level metrics
+ */
+export class ProtocolOverviewService extends BaseService {
+    CACHE_KEY = 'protocol:overview:metrics';
+    CACHE_TTL = 300; // 5 minutes
+    /**
+     * Fetch protocol metrics with caching
+     */
+    async getMetrics() {
+        // Check cache
+        const cached = this.cache.get(this.CACHE_KEY);
+        if (cached) {
+            return cached;
+        }
+        // Fetch from GraphQL
+        const metrics = await this.fetchMetrics();
+        // Cache results
+        this.cache.set(this.CACHE_KEY, metrics, this.CACHE_TTL);
+        return metrics;
+    }
+    /**
+     * Fetch protocol metrics from GraphQL
+     */
+    async fetchMetrics() {
+        const query = `
+      query ProtocolOverview {
+        vaults(first: 1000) {
+          items {
+            id
+            address
+            chain { id }
+            state {
+              totalAssetsUsd
+              managementFee
+              performanceFee
+            }
+            curators {
+              id
+            }
+            createdAt
+          }
+        }
+        events(
+          first: 1000
+          where: { type_in: ["Deposit", "Withdrawal"] }
+          orderBy: "timestamp"
+          orderDirection: "desc"
+        ) {
+          items {
+            timestamp
+            type
+            data {
+              ... on DepositEvent {
+                assetsUsd
+              }
+              ... on WithdrawalEvent {
+                assetsUsd
+              }
+            }
+          }
+        }
+      }
+    `;
+        try {
+            const data = await this.client.request(query);
+            return this.calculateMetrics(data);
+        }
+        catch (error) {
+            // Return fallback metrics on error
+            console.error('Failed to fetch protocol metrics:', error);
+            return this.getFallbackMetrics();
+        }
+    }
+    /**
+     * Calculate protocol metrics from GraphQL data
+     */
+    calculateMetrics(data) {
+        const now = Date.now();
+        const day30Ago = now - 30 * 24 * 60 * 60 * 1000;
+        // Calculate total TVL
+        const totalTVL = data.vaults.items.reduce((sum, v) => sum + (v.state?.totalAssetsUsd || 0), 0);
+        // Calculate vault counts
+        const activeVaults = data.vaults.items.filter((v) => (v.state?.totalAssetsUsd || 0) > 0).length;
+        const vaultsCreatedLast30d = data.vaults.items.filter((v) => new Date(v.createdAt).getTime() > day30Ago).length;
+        // Calculate weighted average APR (simplified - would need more data in real implementation)
+        const avgAPR = 12.5; // Placeholder - needs actual APR calculation from performance data
+        // Calculate median APR
+        const medianAPR = 11.8; // Placeholder - needs actual APR calculation
+        // Calculate 24h volume from events
+        const volume24h = data.events.items
+            .filter((e) => parseInt(e.timestamp, 10) * 1000 > now - 24 * 60 * 60 * 1000)
+            .reduce((sum, e) => sum + (e.data.assetsUsd || 0), 0);
+        // Extract unique user addresses (would need user-specific query in real implementation)
+        const totalUsers = Math.floor(activeVaults * 2.5); // Estimated users per vault
+        const activeUsers30d = Math.floor(totalUsers * 0.35); // 35% monthly active
+        const newUsers30d = Math.floor(totalUsers * 0.15); // 15% new users
+        // Security metrics (would need security incident tracking in real implementation)
+        // TODO: Implement actual 90-day security incident tracking with date filtering
+        const securityIncidents90d = 0;
+        const avgRiskScore = 35; // Average risk score across all vaults
+        // Curator metrics
+        const uniqueCurators = new Set(data.vaults.items.flatMap((v) => v.curators.map((c) => c.id)));
+        const totalCurators = uniqueCurators.size;
+        const activeCurators30d = Math.floor(totalCurators * 0.7); // 70% active monthly
+        // TVL changes (simplified - would need historical data)
+        // TODO: Implement actual historical TVL tracking for 7d/30d change calculations
+        const tvl7dChange = 5.2; // Placeholder percentage
+        const tvl30dChange = 12.3; // Placeholder percentage
+        return {
+            totalTVL,
+            tvl7dChange,
+            tvl30dChange,
+            totalVolume24h: volume24h,
+            activeVaults,
+            vaultsLast30d: vaultsCreatedLast30d,
+            avgAPR,
+            medianAPR,
+            totalUsers,
+            activeUsers30d,
+            newUsers30d,
+            securityIncidents90d,
+            avgRiskScore,
+            totalCurators,
+            activeCurators30d,
+            lastUpdated: new Date().toISOString(),
+        };
+    }
+    /**
+     * Fallback metrics when GraphQL fails
+     */
+    getFallbackMetrics() {
+        return {
+            totalTVL: 0,
+            tvl7dChange: 0,
+            tvl30dChange: 0,
+            totalVolume24h: 0,
+            activeVaults: 0,
+            vaultsLast30d: 0,
+            avgAPR: 0,
+            medianAPR: 0,
+            totalUsers: 0,
+            activeUsers30d: 0,
+            newUsers30d: 0,
+            securityIncidents90d: 0,
+            avgRiskScore: 0,
+            totalCurators: 0,
+            activeCurators30d: 0,
+            lastUpdated: new Date().toISOString(),
+        };
+    }
+    /**
+     * Format TVL with appropriate unit
+     */
+    formatTVL(tvl) {
+        if (tvl >= 1_000_000) {
+            return `$${(tvl / 1_000_000).toFixed(1)}M`;
+        }
+        else if (tvl >= 1_000) {
+            return `$${(tvl / 1_000).toFixed(1)}K`;
+        }
+        else {
+            return `$${tvl.toFixed(0)}`;
+        }
+    }
+    /**
+     * Format percentage change
+     */
+    formatPercentage(value) {
+        const sign = value >= 0 ? '+' : '';
+        return `${sign}${value.toFixed(1)}%`;
+    }
+}
+//# sourceMappingURL=protocol-overview.service.js.map

package/dist/services/analytics/protocol-overview.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-overview.service.js","sourceRoot":"","sources":["../../../src/services/analytics/protocol-overview.service.ts"],"names":[],"mappings":"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"}

package/dist/services/analytics/risk.service.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Risk Analysis Service
+ *
+ * Encapsulates risk analysis business logic with dependency injection.
+ * Demonstrates service layer pattern for complex multi-step operations.
+ */
+import { BaseService } from '../base.service.js';
+import { VaultData } from '../../graphql/fragments/index.js';
+import { RiskScoreBreakdown } from '../../utils/risk-scoring.js';
+/**
+ * Risk analysis input data extracted from GraphQL
+ */
+export interface RiskAnalysisData {
+    vault: VaultData;
+    allVaults: {
+        items: Array<{
+            state: {
+                totalAssetsUsd: number;
+            };
+        }>;
+    };
+    curatorVaults: {
+        items: Array<{
+            address: string;
+            state: {
+                totalAssetsUsd: number;
+            };
+        }>;
+    };
+    priceHistory: {
+        items: Array<{
+            timestamp: string;
+            data: {
+                totalAssets: string;
+                totalAssetsUsd: number;
+                totalSupply: string;
+            };
+        }>;
+    };
+}
+/**
+ * Comparative risk context for benchmarking
+ */
+export interface ComparativeRiskContext {
+    percentile: number;
+    betterThanPercent: number;
+    medianRisk: number;
+    averageRisk: number;
+    isOutlier: boolean;
+    riskRanking: string;
+}
+/**
+ * Extended risk score breakdown with comparative context
+ */
+export interface ExtendedRiskScoreBreakdown extends RiskScoreBreakdown {
+    comparative?: ComparativeRiskContext;
+}
+/**
+ * Risk analysis service for vault risk assessment
+ */
+export declare class RiskService extends BaseService {
+    /**
+     * Fetch risk analysis data from GraphQL
+     */
+    fetchRiskData(vaultAddress: string, chainId: number): Promise<RiskAnalysisData | null>;
+    /**
+     * Calculate risk breakdown from fetched data
+     */
+    calculateRisk(data: RiskAnalysisData): RiskScoreBreakdown;
+    /**
+     * Calculate comparative risk context by benchmarking against all vaults
+     *
+     * @param vaultRisk - Risk score for the target vault
+     * @param allVaultsData - Data for all vaults on the chain
+     * @returns Comparative risk context with percentile rankings
+     */
+    calculateComparativeContext(vaultRisk: number, allVaultsData: RiskAnalysisData['allVaults']): ComparativeRiskContext;
+    /**
+     * Perform complete risk analysis for a vault
+     *
+     * @param vaultAddress - Vault address to analyze
+     * @param chainId - Chain ID of the vault
+     * @param includeComparative - Whether to include comparative benchmarking
+     * @returns Risk score breakdown or null if vault not found
+     */
+    analyze(vaultAddress: string, chainId: number, includeComparative?: boolean): Promise<ExtendedRiskScoreBreakdown | null>;
+    /**
+     * Format risk breakdown as markdown table
+     */
+    formatRiskBreakdown(breakdown: ExtendedRiskScoreBreakdown, responseFormat?: 'score' | 'summary' | 'detailed'): string;
+}
+//# sourceMappingURL=risk.service.d.ts.map

package/dist/services/analytics/risk.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk.service.d.ts","sourceRoot":"","sources":["../../../src/services/analytics/risk.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAE7D,OAAO,EAAe,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE;gBAAE,cAAc,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IACnE,aAAa,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE;gBAAE,cAAc,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IACxF,YAAY,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC;YACX,SAAS,EAAE,MAAM,CAAC;YAClB,IAAI,EAAE;gBACJ,WAAW,EAAE,MAAM,CAAC;gBACpB,cAAc,EAAE,MAAM,CAAC;gBACvB,WAAW,EAAE,MAAM,CAAC;aACrB,CAAC;SACH,CAAC,CAAC;KACJ,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,kBAAkB;IACpE,WAAW,CAAC,EAAE,sBAAsB,CAAC;CACtC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;OAEG;IACG,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAgB5F;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,kBAAkB;IAkHzD;;;;;;OAMG;IACH,2BAA2B,CACzB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,gBAAgB,CAAC,WAAW,CAAC,GAC3C,sBAAsB;IAuEzB;;;;;;;OAOG;IACG,OAAO,CACX,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,kBAAkB,GAAE,OAAc,GACjC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;IA0B7C;;OAEG;IACH,mBAAmB,CACjB,SAAS,EAAE,0BAA0B,EACrC,cAAc,GAAE,OAAO,GAAG,SAAS,GAAG,UAAsB,GAC3D,MAAM;CAkMV"}