@neverinfamous/postgres-mcp 1.0.1

package/dist/adapters/postgresql/resources/settings.js

@@ -0,0 +1,184 @@
+/**
+ * Settings Resource
+ *
+ * Current PostgreSQL configuration settings with production defaults analysis.
+ */
+import { ASSISTANT_FOCUSED } from "../../../utils/resourceAnnotations.js";
+export function createSettingsResource(adapter) {
+    return {
+        uri: "postgres://settings",
+        name: "Server Settings",
+        description: "Current PostgreSQL configuration settings with production defaults analysis",
+        mimeType: "application/json",
+        annotations: ASSISTANT_FOCUSED,
+        handler: async (_uri, _context) => {
+            // Get all settings
+            const result = await adapter.executeQuery(`
+                SELECT name, setting, unit, category, short_desc, boot_val, reset_val
+                FROM pg_settings
+                WHERE category NOT LIKE '%Developer%'
+                ORDER BY category, name
+            `);
+            // Get key settings for analysis
+            const keySettings = await adapter.executeQuery(`
+                SELECT name, setting, unit
+                FROM pg_settings
+                WHERE name IN (
+                    'shared_buffers', 'work_mem', 'maintenance_work_mem', 
+                    'effective_cache_size', 'max_connections',
+                    'wal_level', 'max_wal_senders', 'wal_keep_size',
+                    'ssl', 'password_encryption', 'log_connections', 
+                    'log_disconnections', 'log_statement', 'log_min_duration_statement',
+                    'checkpoint_timeout', 'checkpoint_completion_target'
+                )
+            `);
+            // Build settings map for analysis
+            const settingsMap = new Map();
+            for (const row of keySettings.rows ?? []) {
+                const name = row["name"];
+                const setting = row["setting"];
+                const unit = row["unit"];
+                settingsMap.set(name, { value: setting, unit });
+            }
+            // Generate production recommendations
+            const recommendations = [];
+            // Performance settings
+            const sharedBuffers = settingsMap.get("shared_buffers");
+            if (sharedBuffers) {
+                const valueKb = parseInt(sharedBuffers.value, 10) * 8; // 8KB pages
+                const valueMb = valueKb / 1024;
+                if (valueMb < 256) {
+                    recommendations.push({
+                        setting: "shared_buffers",
+                        currentValue: `${String(valueMb)}MB`,
+                        category: "performance",
+                        priority: "HIGH",
+                        recommendation: "Consider increasing to 25% of available RAM (minimum 256MB for production)",
+                        context: "Default is often too low for production workloads",
+                    });
+                }
+            }
+            const workMem = settingsMap.get("work_mem");
+            if (workMem) {
+                const valueKb = parseInt(workMem.value, 10);
+                if (valueKb < 8192) {
+                    // < 8MB
+                    recommendations.push({
+                        setting: "work_mem",
+                        currentValue: `${String(valueKb)}KB`,
+                        category: "performance",
+                        priority: "MEDIUM",
+                        recommendation: "Consider increasing to 8-64MB for complex queries (balance with max_connections)",
+                        context: "Per-operation memory limit affects sorting and hashing",
+                    });
+                }
+            }
+            const maxConnections = settingsMap.get("max_connections");
+            if (maxConnections && parseInt(maxConnections.value, 10) > 200) {
+                recommendations.push({
+                    setting: "max_connections",
+                    currentValue: maxConnections.value,
+                    category: "performance",
+                    priority: "MEDIUM",
+                    recommendation: "High connection count may waste resources. Consider using connection pooling (pgbouncer)",
+                    context: "Each connection consumes memory; pooling is more efficient",
+                });
+            }
+            // Replication settings
+            const walLevel = settingsMap.get("wal_level");
+            if (walLevel?.value === "minimal") {
+                recommendations.push({
+                    setting: "wal_level",
+                    currentValue: "minimal",
+                    category: "replication",
+                    priority: "HIGH",
+                    recommendation: 'Set to "replica" or "logical" for point-in-time recovery and replication',
+                    context: "Required for backups, replication, and disaster recovery",
+                });
+            }
+            // Security settings
+            const ssl = settingsMap.get("ssl");
+            if (ssl?.value === "off") {
+                recommendations.push({
+                    setting: "ssl",
+                    currentValue: "off",
+                    category: "security",
+                    priority: "HIGH",
+                    recommendation: "Enable SSL for encrypted connections in production",
+                    context: "Protects data in transit from eavesdropping",
+                });
+            }
+            const passwordEncryption = settingsMap.get("password_encryption");
+            if (passwordEncryption?.value === "md5") {
+                recommendations.push({
+                    setting: "password_encryption",
+                    currentValue: "md5",
+                    category: "security",
+                    priority: "MEDIUM",
+                    recommendation: "Consider using scram-sha-256 for stronger password hashing",
+                    context: "MD5 is cryptographically weaker than SCRAM-SHA-256",
+                });
+            }
+            // Logging settings - log_statement = 'none' is often intentional for high-throughput production systems
+            const logStatement = settingsMap.get("log_statement");
+            if (logStatement?.value === "none") {
+                recommendations.push({
+                    setting: "log_statement",
+                    currentValue: "none",
+                    category: "logging",
+                    priority: "LOW",
+                    recommendation: 'For development/debugging: consider "ddl" or "mod". Production systems often keep "none" for performance.',
+                    context: "log_statement=all can significantly impact performance; evaluate based on your environment",
+                });
+            }
+            // Build memory context with absolute values
+            const memoryContext = [];
+            if (sharedBuffers) {
+                const valueKb = parseInt(sharedBuffers.value, 10) * 8;
+                const valueMb = Math.round(valueKb / 1024);
+                memoryContext.push({
+                    setting: "shared_buffers",
+                    currentMb: valueMb,
+                    description: "PostgreSQL buffer cache. Typical recommendation: 25% of system RAM.",
+                });
+            }
+            if (workMem) {
+                const valueKb = parseInt(workMem.value, 10);
+                const valueMb = Math.round(valueKb / 1024);
+                memoryContext.push({
+                    setting: "work_mem",
+                    currentMb: valueMb,
+                    description: "Per-operation memory for sorts/hashes. Used per-sort-step, so effective usage = work_mem × concurrent operations.",
+                });
+            }
+            const maintenanceWorkMem = settingsMap.get("maintenance_work_mem");
+            if (maintenanceWorkMem) {
+                const valueKb = parseInt(maintenanceWorkMem.value, 10);
+                const valueMb = Math.round(valueKb / 1024);
+                memoryContext.push({
+                    setting: "maintenance_work_mem",
+                    currentMb: valueMb,
+                    description: "Memory for VACUUM, CREATE INDEX, ALTER TABLE. Higher values speed up these operations.",
+                });
+            }
+            const effectiveCacheSize = settingsMap.get("effective_cache_size");
+            if (effectiveCacheSize) {
+                const valueKb = parseInt(effectiveCacheSize.value, 10) * 8;
+                const valueGb = Math.round((valueKb / 1024 / 1024) * 10) / 10;
+                memoryContext.push({
+                    setting: "effective_cache_size",
+                    currentMb: Math.round(valueKb / 1024),
+                    description: `Planner estimate of OS cache (~${String(valueGb)}GB). Affects index usage decisions.`,
+                });
+            }
+            return {
+                settings: result.rows,
+                settingsCount: result.rows?.length ?? 0,
+                productionRecommendations: recommendations,
+                memoryContext,
+                analysisNote: 'Recommendations are general guidance based on common best practices. RAM percentages (e.g., "25% of RAM") are theoretical - PostgreSQL cannot detect actual server memory. Review your specific server specs to calculate actual values. Development databases have different optimal settings than production.',
+            };
+        },
+    };
+}
+//# sourceMappingURL=settings.js.map

package/dist/adapters/postgresql/resources/settings.js.map

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

package/dist/adapters/postgresql/resources/stats.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Statistics Resource
+ *
+ * Table and index statistics, cache hit ratios, and stale statistics detection.
+ * Enhanced with stale statistics recommendations from legacy server.
+ */
+import type { PostgresAdapter } from "../PostgresAdapter.js";
+import type { ResourceDefinition } from "../../../types/index.js";
+export declare function createStatsResource(adapter: PostgresAdapter): ResourceDefinition;
+//# sourceMappingURL=stats.d.ts.map

package/dist/adapters/postgresql/resources/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/resources/stats.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,yBAAyB,CAAC;AA2CjC,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,GACvB,kBAAkB,CA2GpB"}

package/dist/adapters/postgresql/resources/stats.js

@@ -0,0 +1,124 @@
+/**
+ * Statistics Resource
+ *
+ * Table and index statistics, cache hit ratios, and stale statistics detection.
+ * Enhanced with stale statistics recommendations from legacy server.
+ */
+import { MEDIUM_PRIORITY } from "../../../utils/resourceAnnotations.js";
+/** Safely convert unknown value to string */
+function toStr(value) {
+    if (typeof value === "string")
+        return value;
+    if (value === null || value === undefined)
+        return "";
+    if (typeof value === "number")
+        return value.toString();
+    return "";
+}
+/** Safely convert unknown value to number */
+function toNum(value) {
+    if (typeof value === "number")
+        return value;
+    if (typeof value === "string")
+        return Number(value) || 0;
+    return 0;
+}
+export function createStatsResource(adapter) {
+    return {
+        uri: "postgres://stats",
+        name: "Database Statistics",
+        description: "Table and index statistics, cache hit ratios, and stale statistics detection",
+        mimeType: "application/json",
+        annotations: MEDIUM_PRIORITY,
+        handler: async (_uri, _context) => {
+            // Table stats with statsStale calculation
+            const tableStats = await adapter.executeQuery(`
+                SELECT schemaname, relname as table_name,
+                       seq_scan, idx_scan, n_tup_ins as inserts,
+                       n_tup_upd as updates, n_tup_del as deletes,
+                       n_live_tup as live_tuples, n_dead_tup as dead_tuples,
+                       n_mod_since_analyze,
+                       CASE
+                           WHEN n_live_tup > 0
+                           THEN round(100.0 * n_mod_since_analyze / n_live_tup, 2)
+                           ELSE 0
+                       END as percent_modified_since_analyze,
+                       CASE
+                           WHEN n_live_tup > 100 AND (100.0 * n_mod_since_analyze / n_live_tup) > 10
+                           THEN true
+                           ELSE false
+                       END as stats_stale
+                FROM pg_stat_user_tables
+                ORDER BY n_live_tup DESC
+                LIMIT 50
+            `);
+            // Cache hit ratio
+            const cacheStats = await adapter.executeQuery(`
+                SELECT 
+                    sum(heap_blks_read) as heap_read,
+                    sum(heap_blks_hit) as heap_hit,
+                    CASE WHEN sum(heap_blks_read) + sum(heap_blks_hit) > 0 
+                        THEN round(100.0 * sum(heap_blks_hit) / (sum(heap_blks_hit) + sum(heap_blks_read)), 2)
+                        ELSE 100 
+                    END as cache_hit_ratio
+                FROM pg_statio_user_tables
+            `);
+            // Process tables with statsStale field
+            const rawTables = tableStats.rows ?? [];
+            const tables = rawTables.map((row) => ({
+                schemaname: toStr(row["schemaname"]),
+                table_name: toStr(row["table_name"]),
+                seq_scan: toNum(row["seq_scan"]),
+                idx_scan: toNum(row["idx_scan"]),
+                inserts: toNum(row["inserts"]),
+                updates: toNum(row["updates"]),
+                deletes: toNum(row["deletes"]),
+                live_tuples: toNum(row["live_tuples"]),
+                dead_tuples: toNum(row["dead_tuples"]),
+                n_mod_since_analyze: toNum(row["n_mod_since_analyze"]),
+                percent_modified_since_analyze: toNum(row["percent_modified_since_analyze"]),
+                statsStale: row["stats_stale"] === true,
+            }));
+            // Generate stale statistics recommendations
+            const recommendations = [];
+            for (const table of tables.slice(0, 10)) {
+                const pctStale = table.percent_modified_since_analyze;
+                // Only flag tables with sufficient rows (small tables don't benefit from ANALYZE)
+                if (table.live_tuples < 100)
+                    continue;
+                if (pctStale > 20) {
+                    recommendations.push({
+                        priority: "HIGH",
+                        table: table.schemaname + "." + table.table_name,
+                        percentStale: pctStale,
+                        statsStale: true,
+                        action: "ANALYZE " + table.schemaname + "." + table.table_name + ";",
+                        reason: "Stale statistics may lead to poor query plans",
+                    });
+                }
+                else if (pctStale > 10) {
+                    recommendations.push({
+                        priority: "MEDIUM",
+                        table: table.schemaname + "." + table.table_name,
+                        percentStale: pctStale,
+                        statsStale: true,
+                        action: "ANALYZE " + table.schemaname + "." + table.table_name + ";",
+                        reason: "Statistics could be fresher for optimal query planning",
+                    });
+                }
+            }
+            if (recommendations.length === 0) {
+                recommendations.push({
+                    priority: "INFO",
+                    message: "Table statistics are up to date",
+                });
+            }
+            return {
+                tableStats: tables,
+                cacheHitRatio: cacheStats.rows?.[0],
+                recommendations,
+            };
+        },
+    };
+}
+//# sourceMappingURL=stats.js.map

package/dist/adapters/postgresql/resources/stats.js.map

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

package/dist/adapters/postgresql/resources/tables.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tables Resource
+ *
+ * List of all tables with metadata (sizes, row counts, etc.).
+ */
+import type { PostgresAdapter } from "../PostgresAdapter.js";
+import type { ResourceDefinition } from "../../../types/index.js";
+export declare function createTablesResource(adapter: PostgresAdapter): ResourceDefinition;
+//# sourceMappingURL=tables.d.ts.map

package/dist/adapters/postgresql/resources/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/resources/tables.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,yBAAyB,CAAC;AAGjC,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,GACvB,kBAAkB,CAapB"}

package/dist/adapters/postgresql/resources/tables.js

@@ -0,0 +1,20 @@
+/**
+ * Tables Resource
+ *
+ * List of all tables with metadata (sizes, row counts, etc.).
+ */
+import { MEDIUM_PRIORITY } from "../../../utils/resourceAnnotations.js";
+export function createTablesResource(adapter) {
+    return {
+        uri: "postgres://tables",
+        name: "Tables List",
+        description: "Lightweight table listing with sizes and row counts. Use postgres://schema for full DDL structure with columns, constraints, and indexes.",
+        mimeType: "application/json",
+        annotations: MEDIUM_PRIORITY,
+        handler: async (_uri, _context) => {
+            const tables = await adapter.listTables();
+            return { tables, count: tables.length };
+        },
+    };
+}
+//# sourceMappingURL=tables.js.map

package/dist/adapters/postgresql/resources/tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.js","sourceRoot":"","sources":["../../../../src/adapters/postgresql/resources/tables.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAExE,MAAM,UAAU,oBAAoB,CAClC,OAAwB;IAExB,OAAO;QACL,GAAG,EAAE,mBAAmB;QACxB,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,2IAA2I;QAC7I,QAAQ,EAAE,kBAAkB;QAC5B,WAAW,EAAE,eAAe;QAC5B,OAAO,EAAE,KAAK,EAAE,IAAY,EAAE,QAAwB,EAAE,EAAE;YACxD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;YAC1C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/postgresql/resources/vacuum.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Vacuum Resource
+ *
+ * Vacuum statistics, dead tuples, and transaction ID wraparound warnings.
+ */
+import type { PostgresAdapter } from "../PostgresAdapter.js";
+import type { ResourceDefinition } from "../../../types/index.js";
+export declare function createVacuumResource(adapter: PostgresAdapter): ResourceDefinition;
+//# sourceMappingURL=vacuum.d.ts.map

package/dist/adapters/postgresql/resources/vacuum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vacuum.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/resources/vacuum.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,yBAAyB,CAAC;AAiCjC,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,GACvB,kBAAkB,CAmIpB"}

package/dist/adapters/postgresql/resources/vacuum.js

@@ -0,0 +1,122 @@
+/**
+ * Vacuum Resource
+ *
+ * Vacuum statistics, dead tuples, and transaction ID wraparound warnings.
+ */
+import { MEDIUM_PRIORITY } from "../../../utils/resourceAnnotations.js";
+export function createVacuumResource(adapter) {
+    return {
+        uri: "postgres://vacuum",
+        name: "Vacuum Status",
+        description: "Vacuum statistics, dead tuples, and transaction ID wraparound warnings",
+        mimeType: "application/json",
+        annotations: MEDIUM_PRIORITY,
+        handler: async (_uri, _context) => {
+            // Get vacuum statistics
+            const vacuumResult = await adapter.executeQuery(`
+                SELECT
+                    schemaname,
+                    relname,
+                    last_vacuum,
+                    last_autovacuum,
+                    last_analyze,
+                    last_autoanalyze,
+                    vacuum_count,
+                    autovacuum_count,
+                    analyze_count,
+                    autoanalyze_count,
+                    n_dead_tup,
+                    n_live_tup,
+                    CASE
+                        WHEN n_live_tup > 0
+                        THEN round(100.0 * n_dead_tup / n_live_tup, 2)
+                        ELSE 0
+                    END as dead_tuple_percent
+                FROM pg_stat_user_tables
+                WHERE schemaname NOT IN ('pg_catalog', 'information_schema')
+                ORDER BY n_dead_tup DESC
+                LIMIT 20
+            `);
+            const vacuumStats = (vacuumResult.rows ?? []);
+            // Get transaction ID wraparound info
+            const wraparoundResult = await adapter.executeQuery(`
+                SELECT
+                    datname,
+                    age(datfrozenxid) as xid_age,
+                    2147483648 - age(datfrozenxid) as xids_until_wraparound,
+                    round(100.0 * age(datfrozenxid) / 2147483648, 2) as percent_toward_wraparound
+                FROM pg_database
+                WHERE datname = current_database()
+            `);
+            const wraparoundRow = (wraparoundResult.rows?.[0] ??
+                null);
+            const wraparoundInfo = wraparoundRow ?? {
+                datname: "",
+                xid_age: 0,
+                xids_until_wraparound: 0,
+                percent_toward_wraparound: 0,
+            };
+            // Generate warnings
+            const warnings = [];
+            const pctWraparound = wraparoundInfo.percent_toward_wraparound;
+            if (pctWraparound > 75) {
+                warnings.push({
+                    severity: "CRITICAL",
+                    message: "Transaction ID wraparound at " + pctWraparound.toString() + "%",
+                    recommendation: "Run VACUUM FREEZE immediately to prevent database shutdown",
+                });
+            }
+            else if (pctWraparound > 50) {
+                warnings.push({
+                    severity: "HIGH",
+                    message: "Transaction ID wraparound at " + pctWraparound.toString() + "%",
+                    recommendation: "Schedule VACUUM FREEZE during maintenance window",
+                });
+            }
+            for (const table of vacuumStats.slice(0, 5)) {
+                // Handle edge case: empty tables (both live and dead = 0)
+                const isEmptyTable = table.n_live_tup === 0 && table.n_dead_tup === 0;
+                // Ensure we have a valid number, not NaN
+                const deadPct = isFinite(table.dead_tuple_percent)
+                    ? table.dead_tuple_percent
+                    : 0;
+                if (isEmptyTable) {
+                    // Skip empty tables in warnings - they don't need vacuum
+                    continue;
+                }
+                if (deadPct > 20) {
+                    warnings.push({
+                        severity: "MEDIUM",
+                        table: table.schemaname + "." + table.relname,
+                        message: deadPct.toString() + "% dead tuples",
+                        recommendation: "Run VACUUM ANALYZE " +
+                            table.schemaname +
+                            "." +
+                            table.relname +
+                            ";",
+                    });
+                }
+            }
+            if (warnings.length === 0) {
+                warnings.push({
+                    severity: "INFO",
+                    message: "Vacuum status looks healthy",
+                });
+            }
+            return {
+                vacuumStatistics: vacuumStats,
+                transactionIdWraparound: {
+                    ...wraparoundInfo,
+                    thresholdExplanation: {
+                        limit: "PostgreSQL uses 32-bit transaction IDs with a 2 billion XID horizon. Approaching this limit requires aggressive vacuuming.",
+                        critical75: ">75%: CRITICAL - Database will shut down to prevent corruption if wraparound occurs. Run VACUUM FREEZE immediately.",
+                        warning50: ">50%: HIGH - Schedule VACUUM FREEZE during maintenance window. Still safe but needs attention.",
+                        healthy: "<50%: Normal operation. Autovacuum should handle routine cleanup.",
+                    },
+                },
+                warnings,
+            };
+        },
+    };
+}
+//# sourceMappingURL=vacuum.js.map

package/dist/adapters/postgresql/resources/vacuum.js.map

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

package/dist/adapters/postgresql/resources/vector.d.ts

@@ -0,0 +1,9 @@
+/**
+ * pgvector Status Resource
+ *
+ * Provides pgvector extension status, vector columns, and index information.
+ */
+import type { PostgresAdapter } from "../PostgresAdapter.js";
+import type { ResourceDefinition } from "../../../types/index.js";
+export declare function createVectorResource(adapter: PostgresAdapter): ResourceDefinition;
+//# sourceMappingURL=vector.d.ts.map

package/dist/adapters/postgresql/resources/vector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/resources/vector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAkDlE,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,GACvB,kBAAkB,CA0OpB"}