wyrm-mcp 3.2.0

package/dist/analytics.js

@@ -0,0 +1,368 @@
+/**
+ * Wyrm Analytics — Persistent Usage Tracking & Cost Monitoring
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd. All Rights Reserved.
+ * @license Proprietary - See LICENSE file for details.
+ * @module analytics
+ * @version 3.2.0
+ */
+// ==================== CONSTANTS ====================
+/** Claude Sonnet pricing per 1M tokens */
+const COST_PER_MILLION_INPUT = 3;
+const COST_PER_MILLION_OUTPUT = 15;
+const BUFFER_FLUSH_THRESHOLD = 50;
+const FLUSH_INTERVAL_MS = 30_000;
+const DEFAULT_RETAIN_DAYS = 90;
+// ==================== ANALYTICS CLASS ====================
+export class WyrmAnalytics {
+    db;
+    insertStmt;
+    batchBuffer;
+    flushInterval;
+    constructor(db) {
+        this.db = db;
+        this.batchBuffer = [];
+        this.initTables();
+        this.insertStmt = this.db.prepare(`
+      INSERT INTO usage_events (tool_name, tokens_in, tokens_out, cached, response_ms, success, error_message, timestamp)
+      VALUES (@tool_name, @tokens_in, @tokens_out, @cached, @response_ms, @success, @error_message, @timestamp)
+    `);
+        this.flushInterval = setInterval(() => {
+            this.flush();
+        }, FLUSH_INTERVAL_MS);
+        // Don't let the timer keep the process alive
+        if (this.flushInterval.unref) {
+            this.flushInterval.unref();
+        }
+    }
+    // ==================== SCHEMA ====================
+    initTables() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS usage_events (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        tool_name TEXT NOT NULL,
+        tokens_in INTEGER DEFAULT 0,
+        tokens_out INTEGER DEFAULT 0,
+        cached INTEGER DEFAULT 0,
+        response_ms INTEGER DEFAULT 0,
+        success INTEGER DEFAULT 1,
+        error_message TEXT,
+        timestamp TEXT DEFAULT (datetime('now'))
+      );
+
+      CREATE TABLE IF NOT EXISTS cost_tracking (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        period TEXT NOT NULL,
+        tool_name TEXT NOT NULL,
+        call_count INTEGER DEFAULT 0,
+        total_tokens_in INTEGER DEFAULT 0,
+        total_tokens_out INTEGER DEFAULT 0,
+        cached_count INTEGER DEFAULT 0,
+        avg_response_ms REAL DEFAULT 0,
+        error_count INTEGER DEFAULT 0,
+        estimated_cost_usd REAL DEFAULT 0,
+        updated_at TEXT DEFAULT (datetime('now')),
+        UNIQUE(period, tool_name)
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_usage_events_tool ON usage_events(tool_name);
+      CREATE INDEX IF NOT EXISTS idx_usage_events_ts ON usage_events(timestamp);
+      CREATE INDEX IF NOT EXISTS idx_cost_tracking_period ON cost_tracking(period);
+    `);
+    }
+    // ==================== RECORDING ====================
+    /** Record a single tool usage event */
+    record(event) {
+        this.batchBuffer.push(event);
+        if (this.batchBuffer.length >= BUFFER_FLUSH_THRESHOLD) {
+            this.flush();
+        }
+    }
+    /** Flush buffered events to disk */
+    flush() {
+        if (this.batchBuffer.length === 0)
+            return;
+        const events = this.batchBuffer.splice(0);
+        const insertMany = this.db.transaction((batch) => {
+            for (const event of batch) {
+                this.insertStmt.run({
+                    tool_name: event.tool,
+                    tokens_in: event.tokens_in,
+                    tokens_out: event.tokens_out,
+                    cached: event.cached ? 1 : 0,
+                    response_ms: event.ms,
+                    success: event.success !== false ? 1 : 0,
+                    error_message: event.error ?? null,
+                    timestamp: event.timestamp,
+                });
+            }
+        });
+        insertMany(events);
+        this.updateCostTracking(events);
+    }
+    /** Update cost_tracking aggregates from a batch of events */
+    updateCostTracking(events) {
+        const groups = new Map();
+        for (const event of events) {
+            const period = event.timestamp.slice(0, 7); // YYYY-MM
+            const key = `${period}:${event.tool}`;
+            let group = groups.get(key);
+            if (!group) {
+                group = { tool: event.tool, period, calls: 0, tokens_in: 0, tokens_out: 0, cached: 0, total_ms: 0, errors: 0 };
+                groups.set(key, group);
+            }
+            group.calls++;
+            group.tokens_in += event.tokens_in;
+            group.tokens_out += event.tokens_out;
+            if (event.cached)
+                group.cached++;
+            group.total_ms += event.ms;
+            if (event.success === false)
+                group.errors++;
+        }
+        const upsertStmt = this.db.prepare(`
+      INSERT INTO cost_tracking (period, tool_name, call_count, total_tokens_in, total_tokens_out, cached_count, avg_response_ms, error_count, estimated_cost_usd, updated_at)
+      VALUES (@period, @tool_name, @call_count, @total_tokens_in, @total_tokens_out, @cached_count, @avg_response_ms, @error_count, @estimated_cost_usd, datetime('now'))
+      ON CONFLICT(period, tool_name) DO UPDATE SET
+        call_count = call_count + @call_count,
+        total_tokens_in = total_tokens_in + @total_tokens_in,
+        total_tokens_out = total_tokens_out + @total_tokens_out,
+        cached_count = cached_count + @cached_count,
+        avg_response_ms = (avg_response_ms * call_count + @avg_response_ms * @call_count) / (call_count + @call_count),
+        error_count = error_count + @error_count,
+        estimated_cost_usd = estimated_cost_usd + @estimated_cost_usd,
+        updated_at = datetime('now')
+    `);
+        const upsertMany = this.db.transaction((entries) => {
+            for (const group of entries.values()) {
+                const cost = this.estimateCost(group.tokens_in, group.tokens_out);
+                upsertStmt.run({
+                    period: group.period,
+                    tool_name: group.tool,
+                    call_count: group.calls,
+                    total_tokens_in: group.tokens_in,
+                    total_tokens_out: group.tokens_out,
+                    cached_count: group.cached,
+                    avg_response_ms: group.calls > 0 ? group.total_ms / group.calls : 0,
+                    error_count: group.errors,
+                    estimated_cost_usd: cost,
+                });
+            }
+        });
+        upsertMany(groups);
+    }
+    // ==================== QUERIES ====================
+    /** Get dashboard summary for a time period */
+    dashboard(days = 30) {
+        // Ensure buffered data is included
+        this.flush();
+        const start = new Date();
+        start.setDate(start.getDate() - days);
+        const startStr = start.toISOString().slice(0, 10);
+        const endStr = new Date().toISOString().slice(0, 10);
+        const summary = this.db.prepare(`
+      SELECT
+        COUNT(*) AS total_calls,
+        COUNT(DISTINCT tool_name) AS unique_tools,
+        COALESCE(SUM(tokens_in), 0) AS total_tokens_in,
+        COALESCE(SUM(tokens_out), 0) AS total_tokens_out,
+        CASE WHEN COUNT(*) > 0
+          THEN ROUND(SUM(cached) * 100.0 / COUNT(*), 2)
+          ELSE 0
+        END AS cache_hit_rate,
+        COALESCE(ROUND(AVG(response_ms), 2), 0) AS avg_response_ms,
+        CASE WHEN COUNT(*) > 0
+          THEN ROUND(SUM(CASE WHEN success = 0 THEN 1 ELSE 0 END) * 100.0 / COUNT(*), 2)
+          ELSE 0
+        END AS error_rate
+      FROM usage_events
+      WHERE timestamp >= @start
+    `).get({ start: startStr });
+        const top_tools = this.db.prepare(`
+      SELECT
+        tool_name AS tool,
+        COUNT(*) AS calls,
+        COALESCE(SUM(tokens_in + tokens_out), 0) AS tokens
+      FROM usage_events
+      WHERE timestamp >= @start
+      GROUP BY tool_name
+      ORDER BY calls DESC
+      LIMIT 10
+    `).all({ start: startStr });
+        const daily = this.db.prepare(`
+      SELECT
+        DATE(timestamp) AS date,
+        COUNT(*) AS calls,
+        COALESCE(SUM(tokens_in + tokens_out), 0) AS tokens,
+        SUM(CASE WHEN success = 0 THEN 1 ELSE 0 END) AS errors
+      FROM usage_events
+      WHERE timestamp >= @start
+      GROUP BY DATE(timestamp)
+      ORDER BY date ASC
+    `).all({ start: startStr });
+        const estimated_cost_usd = this.estimateCost(summary.total_tokens_in, summary.total_tokens_out);
+        return {
+            period: { start: startStr, end: endStr },
+            summary: {
+                total_calls: summary.total_calls,
+                unique_tools: summary.unique_tools,
+                total_tokens_in: summary.total_tokens_in,
+                total_tokens_out: summary.total_tokens_out,
+                cache_hit_rate: summary.cache_hit_rate,
+                avg_response_ms: summary.avg_response_ms,
+                error_rate: summary.error_rate,
+                estimated_cost_usd,
+            },
+            top_tools,
+            daily,
+        };
+    }
+    /** Get per-tool breakdown */
+    toolBreakdown(toolName, days = 30) {
+        this.flush();
+        const start = new Date();
+        start.setDate(start.getDate() - days);
+        const startStr = start.toISOString().slice(0, 10);
+        const stats = this.db.prepare(`
+      SELECT
+        COUNT(*) AS total_calls,
+        COALESCE(ROUND(AVG(tokens_in), 2), 0) AS avg_tokens_in,
+        COALESCE(ROUND(AVG(tokens_out), 2), 0) AS avg_tokens_out,
+        COALESCE(ROUND(AVG(response_ms), 2), 0) AS avg_response_ms,
+        CASE WHEN COUNT(*) > 0
+          THEN ROUND(SUM(cached) * 100.0 / COUNT(*), 2)
+          ELSE 0
+        END AS cache_hit_rate,
+        CASE WHEN COUNT(*) > 0
+          THEN ROUND(SUM(CASE WHEN success = 0 THEN 1 ELSE 0 END) * 100.0 / COUNT(*), 2)
+          ELSE 0
+        END AS error_rate
+      FROM usage_events
+      WHERE tool_name = @tool AND timestamp >= @start
+    `).get({ tool: toolName, start: startStr });
+        const daily = this.db.prepare(`
+      SELECT
+        DATE(timestamp) AS date,
+        COUNT(*) AS calls
+      FROM usage_events
+      WHERE tool_name = @tool AND timestamp >= @start
+      GROUP BY DATE(timestamp)
+      ORDER BY date ASC
+    `).all({ tool: toolName, start: startStr });
+        return {
+            tool: toolName,
+            total_calls: stats.total_calls,
+            avg_tokens_in: stats.avg_tokens_in,
+            avg_tokens_out: stats.avg_tokens_out,
+            avg_response_ms: stats.avg_response_ms,
+            cache_hit_rate: stats.cache_hit_rate,
+            error_rate: stats.error_rate,
+            daily,
+        };
+    }
+    /** Get cost estimate for a period */
+    costReport(period) {
+        this.flush();
+        const targetPeriod = period ?? new Date().toISOString().slice(0, 7);
+        const tools = this.db.prepare(`
+      SELECT
+        tool_name AS tool,
+        call_count AS calls,
+        total_tokens_in AS tokens_in,
+        total_tokens_out AS tokens_out,
+        estimated_cost_usd AS cost_usd
+      FROM cost_tracking
+      WHERE period = @period
+      ORDER BY estimated_cost_usd DESC
+    `).all({ period: targetPeriod });
+        const total_cost_usd = tools.reduce((sum, t) => sum + t.cost_usd, 0);
+        // Project monthly cost based on days elapsed in the period
+        const now = new Date();
+        const periodYear = parseInt(targetPeriod.slice(0, 4), 10);
+        const periodMonth = parseInt(targetPeriod.slice(5, 7), 10) - 1;
+        const periodStart = new Date(periodYear, periodMonth, 1);
+        const periodEnd = new Date(periodYear, periodMonth + 1, 0); // last day of month
+        const totalDaysInMonth = periodEnd.getDate();
+        const elapsed = Math.max(1, Math.ceil((now.getTime() - periodStart.getTime()) / (1000 * 60 * 60 * 24)));
+        const daysToProject = Math.min(elapsed, totalDaysInMonth);
+        const projected_monthly_usd = totalDaysInMonth > 0
+            ? Math.round(((total_cost_usd / daysToProject) * totalDaysInMonth) * 100) / 100
+            : total_cost_usd;
+        return {
+            period: targetPeriod,
+            tools,
+            total_cost_usd: Math.round(total_cost_usd * 100) / 100,
+            projected_monthly_usd,
+        };
+    }
+    /** Clean up old events (retention policy) */
+    cleanup(retainDays = DEFAULT_RETAIN_DAYS) {
+        this.flush();
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - retainDays);
+        const cutoffStr = cutoff.toISOString().slice(0, 10);
+        // Aggregate old events into cost_tracking before deleting
+        const oldEvents = this.db.prepare(`
+      SELECT
+        STRFTIME('%Y-%m', timestamp) AS period,
+        tool_name,
+        COUNT(*) AS call_count,
+        COALESCE(SUM(tokens_in), 0) AS total_tokens_in,
+        COALESCE(SUM(tokens_out), 0) AS total_tokens_out,
+        SUM(cached) AS cached_count,
+        COALESCE(AVG(response_ms), 0) AS avg_response_ms,
+        SUM(CASE WHEN success = 0 THEN 1 ELSE 0 END) AS error_count
+      FROM usage_events
+      WHERE timestamp < @cutoff
+      GROUP BY STRFTIME('%Y-%m', timestamp), tool_name
+    `).all({ cutoff: cutoffStr });
+        const upsertStmt = this.db.prepare(`
+      INSERT INTO cost_tracking (period, tool_name, call_count, total_tokens_in, total_tokens_out, cached_count, avg_response_ms, error_count, estimated_cost_usd, updated_at)
+      VALUES (@period, @tool_name, @call_count, @total_tokens_in, @total_tokens_out, @cached_count, @avg_response_ms, @error_count, @estimated_cost_usd, datetime('now'))
+      ON CONFLICT(period, tool_name) DO UPDATE SET
+        call_count = call_count + @call_count,
+        total_tokens_in = total_tokens_in + @total_tokens_in,
+        total_tokens_out = total_tokens_out + @total_tokens_out,
+        cached_count = cached_count + @cached_count,
+        avg_response_ms = (avg_response_ms * call_count + @avg_response_ms * @call_count) / (call_count + @call_count),
+        error_count = error_count + @error_count,
+        estimated_cost_usd = estimated_cost_usd + @estimated_cost_usd,
+        updated_at = datetime('now')
+    `);
+        const cleanupTxn = this.db.transaction(() => {
+            for (const row of oldEvents) {
+                const cost = this.estimateCost(row.total_tokens_in, row.total_tokens_out);
+                upsertStmt.run({
+                    period: row.period,
+                    tool_name: row.tool_name,
+                    call_count: row.call_count,
+                    total_tokens_in: row.total_tokens_in,
+                    total_tokens_out: row.total_tokens_out,
+                    cached_count: row.cached_count,
+                    avg_response_ms: row.avg_response_ms,
+                    error_count: row.error_count,
+                    estimated_cost_usd: cost,
+                });
+            }
+            const result = this.db.prepare(`
+        DELETE FROM usage_events WHERE timestamp < @cutoff
+      `).run({ cutoff: cutoffStr });
+            return result.changes;
+        });
+        const deleted = cleanupTxn();
+        return { deleted };
+    }
+    /** Shutdown: flush remaining buffer and clear timer */
+    shutdown() {
+        clearInterval(this.flushInterval);
+        this.flush();
+    }
+    // ==================== HELPERS ====================
+    /** Estimate USD cost from token counts (Claude Sonnet rates) */
+    estimateCost(tokensIn, tokensOut) {
+        const inputCost = (tokensIn / 1_000_000) * COST_PER_MILLION_INPUT;
+        const outputCost = (tokensOut / 1_000_000) * COST_PER_MILLION_OUTPUT;
+        return Math.round((inputCost + outputCost) * 1_000_000) / 1_000_000;
+    }
+}
+//# sourceMappingURL=analytics.js.map

package/dist/analytics.js.map

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

package/dist/auto-orchestrator.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Wyrm Auto-Orchestrator - Automatically apply reasoning patterns
+ *
+ * This layer intercepts task requests and automatically applies
+ * the best multi-agent reasoning pattern based on task classification.
+ *
+ * Patterns applied automatically:
+ * - Haiku Boosting: All content generation via few-shot + self-critique
+ * - Ensemble Voting: Decisions (architecture, design, strategy) via N approaches + vote
+ * - Task Decomposition: Large features via subtasks + parallel execution
+ * - Verification: High-risk code changes via multi-angle review
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd. All Rights Reserved.
+ * @license Proprietary - See LICENSE file for details.
+ */
+export type TaskType = 'decision' | 'generation' | 'research' | 'verification' | 'decomposition';
+export interface ClassifiedTask {
+    type: TaskType;
+    confidence: number;
+    description: string;
+    complexity: 'low' | 'medium' | 'high';
+    recommendedApproach: string;
+    parallelBlocks?: number;
+}
+export interface OrchestrationConfig {
+    autoOrchestrateEnabled: boolean;
+    minConfidenceThreshold: number;
+    maxParallelAgents: number;
+    defaultHaikuBoosting: boolean;
+    trackMetrics: boolean;
+    thinkingBudget?: number;
+}
+export interface OrchestrationResult {
+    taskType: TaskType;
+    approach: string;
+    results: unknown;
+    quality: number;
+    costSavings: number;
+    parallelExecutionTime: number;
+    confidence: number;
+    appliedPatterns: string[];
+    metrics: {
+        tokensBoosting: number;
+        tokensEnsemble: number;
+        tokensVerification: number;
+        totalTokens: number;
+    };
+}
+/**
+ * Classify incoming task based on multiple signals
+ */
+export declare function classifyTask(input: string, context?: {
+    projectType?: string;
+    recentTasks?: string[];
+    complexity?: string;
+}): ClassifiedTask;
+/**
+ * Default orchestration config
+ */
+export declare function getDefaultConfig(): OrchestrationConfig;
+/**
+ * Apply appropriate orchestration pattern
+ */
+export declare function orchestrateTask(task: string, config?: OrchestrationConfig): Promise<OrchestrationResult>;
+/**
+ * Orchestration middleware for agent context
+ *
+ * Usage in agent:
+ * ```typescript
+ * const config = getDefaultConfig();
+ * const task = "Design a microservice architecture for a real-time collaboration tool";
+ * const plan = await orchestrateTask(task, config);
+ *
+ * if (plan.appliedPatterns.length > 0) {
+ *   // Auto-orchestration active
+ *   // Implementation would:
+ *   // 1. Spawn parallel agents (if ensemble/decomposition)
+ *   // 2. Apply boosting (if generation)
+ *   // 3. Run reviews (if verification)
+ *   // 4. Synthesize results
+ *   // 5. Store metrics in Wyrm
+ * }
+ * ```
+ */
+export declare class AutoOrchestrator {
+    private config;
+    private taskHistory;
+    constructor(config?: Partial<OrchestrationConfig>);
+    /**
+     * Process incoming task with auto-orchestration
+     */
+    processTask(task: string): Promise<OrchestrationResult>;
+    /**
+     * Get task classification insight
+     */
+    getTaskDistribution(): Record<TaskType, number>;
+    /**
+     * Get orchestration effectiveness stats
+     */
+    getStats(): {
+        tasksProcessed: number;
+        distribution: Record<TaskType, number>;
+        estimatedQualityBoost: number;
+        estimatedCostSavings: number;
+        averageComplexity: 'low' | 'medium' | 'high';
+    };
+    /**
+     * Get pattern set for task type
+     */
+    private getPatternSetForType;
+    /**
+     * Update config at runtime
+     */
+    updateConfig(updates: Partial<OrchestrationConfig>): void;
+}
+export declare function getGlobalOrchestrator(): AutoOrchestrator;
+export declare function initializeOrchestrator(config?: Partial<OrchestrationConfig>): AutoOrchestrator;
+//# sourceMappingURL=auto-orchestrator.d.ts.map

package/dist/auto-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-orchestrator.d.ts","sourceRoot":"","sources":["../src/auto-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,QAAQ,GAChB,UAAU,GACV,YAAY,GACZ,UAAU,GACV,cAAc,GACd,eAAe,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACtC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,sBAAsB,EAAE,OAAO,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9E,cAAc,CA2DhB;AAgCD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,mBAAmB,CAStD;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,mBAAwC,GAC/C,OAAO,CAAC,mBAAmB,CAAC,CAmE9B;AA+BD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,WAAW,CAAwB;gBAE/B,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAOjD;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAY7D;;OAEG;IACH,mBAAmB,IAAI,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC;IAgB/C;;OAEG;IACH,QAAQ,IAAI;QACV,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACvC,qBAAqB,EAAE,MAAM,CAAC;QAC9B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,iBAAiB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;KAC9C;IA6BD;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;CAG1D;AAOD,wBAAgB,qBAAqB,IAAI,gBAAgB,CAKxD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,gBAAgB,CAG9F"}