@neverinfamous/mysql-mcp 2.1.0

package/dist/adapters/mysql/tools/stats/descriptive.js

@@ -0,0 +1,403 @@
+/**
+ * MySQL Descriptive Statistics Tools
+ *
+ * Tools for basic statistical analysis: descriptive stats, percentiles,
+ * distribution, time series, and sampling.
+ * 5 tools total.
+ */
+import { z } from 'zod';
+// =============================================================================
+// Schemas
+// =============================================================================
+const DescriptiveStatsSchema = z.object({
+    table: z.string().describe('Table name'),
+    column: z.string().describe('Numeric column name'),
+    where: z.string().optional().describe('Optional WHERE clause condition')
+});
+const PercentilesSchema = z.object({
+    table: z.string().describe('Table name'),
+    column: z.string().describe('Numeric column name'),
+    percentiles: z.array(z.number().min(0).max(100)).default([25, 50, 75, 90, 95, 99]).describe('Percentiles to calculate'),
+    where: z.string().optional().describe('Optional WHERE clause condition')
+});
+const DistributionSchema = z.object({
+    table: z.string().describe('Table name'),
+    column: z.string().describe('Column to analyze'),
+    buckets: z.number().default(10).describe('Number of histogram buckets'),
+    where: z.string().optional().describe('Optional WHERE clause condition')
+});
+const TimeSeriesSchema = z.object({
+    table: z.string().describe('Table name'),
+    valueColumn: z.string().describe('Numeric column for values'),
+    timeColumn: z.string().describe('Timestamp/datetime column'),
+    interval: z.enum(['minute', 'hour', 'day', 'week', 'month']).default('day').describe('Aggregation interval'),
+    aggregation: z.enum(['avg', 'sum', 'count', 'min', 'max']).default('avg').describe('Aggregation function'),
+    where: z.string().optional().describe('Optional WHERE clause condition'),
+    limit: z.number().default(100).describe('Maximum number of data points')
+});
+const SamplingSchema = z.object({
+    table: z.string().describe('Table name'),
+    sampleSize: z.number().default(100).describe('Number of rows to sample'),
+    columns: z.array(z.string()).optional().describe('Columns to include (all if not specified)'),
+    seed: z.number().optional().describe('Random seed for reproducibility'),
+    where: z.string().optional().describe('Optional WHERE clause condition')
+});
+// =============================================================================
+// Tool Creation Functions
+// =============================================================================
+/**
+ * Calculate descriptive statistics
+ */
+export function createDescriptiveStatsTool(adapter) {
+    return {
+        name: 'mysql_stats_descriptive',
+        title: 'MySQL Descriptive Statistics',
+        description: 'Calculate descriptive statistics (mean, median, stddev, min, max, count) for a numeric column.',
+        group: 'stats',
+        inputSchema: DescriptiveStatsSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { table, column, where } = DescriptiveStatsSchema.parse(params);
+            // Validate identifiers
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(table)) {
+                throw new Error('Invalid table name');
+            }
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(column)) {
+                throw new Error('Invalid column name');
+            }
+            const whereClause = where ? `WHERE ${where}` : '';
+            // Get basic count for median calculation
+            const countResult = await adapter.executeQuery(`SELECT COUNT(*) as count FROM \`${table}\` ${whereClause}`);
+            const totalCount = (countResult.rows?.[0])?.['count'] ?? 0;
+            if (totalCount === 0) {
+                return {
+                    column,
+                    count: 0,
+                    mean: null,
+                    median: null,
+                    stddev: null,
+                    variance: null,
+                    min: null,
+                    max: null,
+                    range: null,
+                    sum: null
+                };
+            }
+            // Calculate median offset/limit
+            const limit = 2 - (totalCount % 2);
+            const offset = Math.floor((totalCount - 1) / 2);
+            const medianQuery = `
+                SELECT AVG(val) as median
+                FROM (
+                    SELECT \`${column}\` as val
+                    FROM \`${table}\`
+                    ${whereClause}
+                    ORDER BY \`${column}\`
+                    LIMIT ${String(limit)}
+                    OFFSET ${String(offset)}
+                ) as median_calc
+            `;
+            const query = `
+                SELECT 
+                    COUNT(\`${column}\`) as count,
+                    AVG(\`${column}\`) as mean,
+                    STD(\`${column}\`) as stddev,
+                    VAR_POP(\`${column}\`) as variance,
+                    MIN(\`${column}\`) as min,
+                    MAX(\`${column}\`) as max,
+                    MAX(\`${column}\`) - MIN(\`${column}\`) as \`range\`,
+                    SUM(\`${column}\`) as sum
+                FROM \`${table}\`
+                ${whereClause}
+            `;
+            const [statsResult, medianResult] = await Promise.all([
+                adapter.executeQuery(query),
+                adapter.executeQuery(medianQuery)
+            ]);
+            const stats = statsResult.rows?.[0];
+            const medianRow = medianResult.rows?.[0];
+            return {
+                column,
+                count: stats?.['count'] ?? 0,
+                mean: stats?.['mean'] ?? null,
+                median: medianRow?.['median'] ?? null,
+                stddev: stats?.['stddev'] ?? null,
+                variance: stats?.['variance'] ?? null,
+                min: stats?.['min'] ?? null,
+                max: stats?.['max'] ?? null,
+                range: stats?.['range'] ?? null,
+                sum: stats?.['sum'] ?? null
+            };
+        }
+    };
+}
+/**
+ * Calculate percentiles
+ */
+export function createPercentilesTool(adapter) {
+    return {
+        name: 'mysql_stats_percentiles',
+        title: 'MySQL Percentiles',
+        description: 'Calculate percentile values for a numeric column.',
+        group: 'stats',
+        inputSchema: PercentilesSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { table, column, percentiles, where } = PercentilesSchema.parse(params);
+            // Validate identifiers
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(table)) {
+                throw new Error('Invalid table name');
+            }
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(column)) {
+                throw new Error('Invalid column name');
+            }
+            const whereClause = where ? `WHERE ${where}` : '';
+            // Get total count
+            const countResult = await adapter.executeQuery(`SELECT COUNT(*) as cnt FROM \`${table}\` ${whereClause}`);
+            const totalCount = (countResult.rows?.[0])?.['cnt'] ?? 0;
+            if (totalCount === 0) {
+                return {
+                    column,
+                    totalCount: 0,
+                    percentiles: {}
+                };
+            }
+            // Calculate each percentile
+            const percentileResults = {};
+            for (const p of percentiles) {
+                const offset = Math.floor((p / 100) * (totalCount - 1));
+                const query = `
+                    SELECT \`${column}\` as value
+                    FROM \`${table}\`
+                    ${whereClause}
+                    ORDER BY \`${column}\`
+                    LIMIT 1 OFFSET ${String(offset)}
+                `;
+                const result = await adapter.executeQuery(query);
+                const valueRow = result.rows?.[0];
+                percentileResults[`p${String(p)}`] = valueRow?.['value'] ?? null;
+            }
+            return {
+                column,
+                totalCount,
+                percentiles: percentileResults
+            };
+        }
+    };
+}
+/**
+ * Analyze data distribution
+ */
+export function createDistributionTool(adapter) {
+    return {
+        name: 'mysql_stats_distribution',
+        title: 'MySQL Distribution Analysis',
+        description: 'Analyze the distribution of values in a column with histogram buckets.',
+        group: 'stats',
+        inputSchema: DistributionSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { table, column, buckets, where } = DistributionSchema.parse(params);
+            // Validate identifiers
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(table)) {
+                throw new Error('Invalid table name');
+            }
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(column)) {
+                throw new Error('Invalid column name');
+            }
+            const whereClause = where ? `WHERE ${where}` : '';
+            // Get min/max for bucket calculation
+            const rangeResult = await adapter.executeQuery(`SELECT MIN(\`${column}\`) as min_val, MAX(\`${column}\`) as max_val FROM \`${table}\` ${whereClause}`);
+            const rangeRow = rangeResult.rows?.[0];
+            const minVal = rangeRow?.['min_val'] ?? 0;
+            const maxVal = rangeRow?.['max_val'] ?? 0;
+            if (minVal === maxVal) {
+                return {
+                    column,
+                    distribution: [{ bucket: 0, rangeStart: minVal, rangeEnd: maxVal, count: 1 }],
+                    bucketCount: 1,
+                    minValue: minVal,
+                    maxValue: maxVal
+                };
+            }
+            const bucketSize = (maxVal - minVal) / buckets;
+            // Generate distribution query with WIDTH_BUCKET emulation
+            const query = `
+                SELECT 
+                    FLOOR((\`${column}\` - ${String(minVal)}) / ${String(bucketSize)}) as bucket,
+                    COUNT(*) as count,
+                    MIN(\`${column}\`) as bucket_min,
+                    MAX(\`${column}\`) as bucket_max
+                FROM \`${table}\`
+                ${whereClause}
+                GROUP BY bucket
+                ORDER BY bucket
+            `;
+            const result = await adapter.executeQuery(query);
+            // Format buckets with proper ranges
+            const distribution = (result.rows ?? []).map((row) => {
+                const r = row;
+                const bucketNum = r['bucket'];
+                return {
+                    bucket: bucketNum,
+                    rangeStart: minVal + (bucketNum * bucketSize),
+                    rangeEnd: minVal + ((bucketNum + 1) * bucketSize),
+                    count: r['count'],
+                    bucketMin: r['bucket_min'],
+                    bucketMax: r['bucket_max']
+                };
+            });
+            return {
+                column,
+                distribution,
+                bucketCount: buckets,
+                bucketSize,
+                minValue: minVal,
+                maxValue: maxVal
+            };
+        }
+    };
+}
+/**
+ * Time series analysis with moving averages
+ */
+export function createTimeSeriesToolStats(adapter) {
+    return {
+        name: 'mysql_stats_time_series',
+        title: 'MySQL Time Series Analysis',
+        description: 'Aggregate and analyze time series data with specified intervals.',
+        group: 'stats',
+        inputSchema: TimeSeriesSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { table, valueColumn, timeColumn, interval, aggregation, where, limit } = TimeSeriesSchema.parse(params);
+            // Validate identifiers
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(table)) {
+                throw new Error('Invalid table name');
+            }
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(valueColumn) || !/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(timeColumn)) {
+                throw new Error('Invalid column name');
+            }
+            let dateFormat;
+            switch (interval) {
+                case 'minute':
+                    dateFormat = '%Y-%m-%d %H:%i:00';
+                    break;
+                case 'hour':
+                    dateFormat = '%Y-%m-%d %H:00:00';
+                    break;
+                case 'day':
+                    dateFormat = '%Y-%m-%d';
+                    break;
+                case 'week':
+                    dateFormat = '%Y-%u';
+                    break;
+                case 'month':
+                    dateFormat = '%Y-%m';
+                    break;
+            }
+            const whereClause = where ? `WHERE ${where}` : '';
+            const aggFunc = aggregation.toUpperCase();
+            const query = `
+                SELECT 
+                    DATE_FORMAT(\`${timeColumn}\`, '${dateFormat}') as period,
+                    ${aggFunc}(\`${valueColumn}\`) as value,
+                    COUNT(*) as data_points,
+                    MIN(\`${valueColumn}\`) as period_min,
+                    MAX(\`${valueColumn}\`) as period_max
+                FROM \`${table}\`
+                ${whereClause}
+                GROUP BY period
+                ORDER BY period DESC
+                LIMIT ${String(limit)}
+            `;
+            const result = await adapter.executeQuery(query);
+            return {
+                interval,
+                aggregation,
+                valueColumn,
+                timeColumn,
+                dataPoints: result.rows ?? [],
+                count: result.rows?.length ?? 0
+            };
+        }
+    };
+}
+/**
+ * Random sampling
+ */
+export function createSamplingTool(adapter) {
+    return {
+        name: 'mysql_stats_sampling',
+        title: 'MySQL Random Sampling',
+        description: 'Get a random sample of rows from a table.',
+        group: 'stats',
+        inputSchema: SamplingSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: false // Random results
+        },
+        handler: async (params, _context) => {
+            const { table, sampleSize, columns, seed, where } = SamplingSchema.parse(params);
+            // Validate table name
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(table)) {
+                throw new Error('Invalid table name');
+            }
+            // Validate column names if provided
+            const columnList = columns !== undefined && columns.length > 0
+                ? columns.map(c => {
+                    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(c)) {
+                        throw new Error(`Invalid column name: ${c}`);
+                    }
+                    return `\`${c}\``;
+                }).join(', ')
+                : '*';
+            const whereClause = where ? `WHERE ${where}` : '';
+            // If seed is provided, use it for reproducibility
+            let query;
+            if (seed !== undefined) {
+                query = `
+                    SELECT ${columnList}
+                    FROM \`${table}\`
+                    ${whereClause}
+                    ORDER BY RAND(${String(seed)})
+                    LIMIT ${String(sampleSize)}
+                `;
+            }
+            else {
+                query = `
+                    SELECT ${columnList}
+                    FROM \`${table}\`
+                    ${whereClause}
+                    ORDER BY RAND()
+                    LIMIT ${String(sampleSize)}
+                `;
+            }
+            const result = await adapter.executeQuery(query);
+            return {
+                sample: result.rows ?? [],
+                sampleSize: result.rows?.length ?? 0,
+                requestedSize: sampleSize,
+                seed: seed ?? null
+            };
+        }
+    };
+}
+//# sourceMappingURL=descriptive.js.map

package/dist/adapters/mysql/tools/stats/descriptive.js.map

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

package/dist/adapters/mysql/tools/stats/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * MySQL Statistics Tools
+ *
+ * Tools for statistical analysis of data.
+ * 8 tools total (5 descriptive + 3 comparative).
+ */
+import type { MySQLAdapter } from '../../MySQLAdapter.js';
+import type { ToolDefinition } from '../../../../types/index.js';
+/**
+ * Get all statistics tools
+ */
+export declare function getStatsTools(adapter: MySQLAdapter): ToolDefinition[];
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/mysql/tools/stats/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/mysql/tools/stats/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAiBjE;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,EAAE,CAWrE"}

package/dist/adapters/mysql/tools/stats/index.js

@@ -0,0 +1,25 @@
+/**
+ * MySQL Statistics Tools
+ *
+ * Tools for statistical analysis of data.
+ * 8 tools total (5 descriptive + 3 comparative).
+ */
+// Import from submodules
+import { createDescriptiveStatsTool, createPercentilesTool, createDistributionTool, createTimeSeriesToolStats, createSamplingTool } from './descriptive.js';
+import { createCorrelationTool, createRegressionTool, createHistogramTool } from './comparative.js';
+/**
+ * Get all statistics tools
+ */
+export function getStatsTools(adapter) {
+    return [
+        createDescriptiveStatsTool(adapter),
+        createPercentilesTool(adapter),
+        createCorrelationTool(adapter),
+        createDistributionTool(adapter),
+        createTimeSeriesToolStats(adapter),
+        createRegressionTool(adapter),
+        createSamplingTool(adapter),
+        createHistogramTool(adapter)
+    ];
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/mysql/tools/stats/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/adapters/mysql/tools/stats/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,yBAAyB;AACzB,OAAO,EACH,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB,EACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACH,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACtB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAqB;IAC/C,OAAO;QACH,0BAA0B,CAAC,OAAO,CAAC;QACnC,qBAAqB,CAAC,OAAO,CAAC;QAC9B,qBAAqB,CAAC,OAAO,CAAC;QAC9B,sBAAsB,CAAC,OAAO,CAAC;QAC/B,yBAAyB,CAAC,OAAO,CAAC;QAClC,oBAAoB,CAAC,OAAO,CAAC;QAC7B,kBAAkB,CAAC,OAAO,CAAC;QAC3B,mBAAmB,CAAC,OAAO,CAAC;KAC/B,CAAC;AACN,CAAC"}

package/dist/adapters/mysql/tools/sysschema/activity.d.ts

@@ -0,0 +1,17 @@
+/**
+ * MySQL sys Schema Tools - Activity Monitoring
+ *
+ * Tools for monitoring user and host activity.
+ * 2 tools: user_summary, host_summary.
+ */
+import type { MySQLAdapter } from '../../MySQLAdapter.js';
+import type { ToolDefinition } from '../../../../types/index.js';
+/**
+ * Get user activity summary
+ */
+export declare function createSysUserSummaryTool(adapter: MySQLAdapter): ToolDefinition;
+/**
+ * Get host connection summary
+ */
+export declare function createSysHostSummaryTool(adapter: MySQLAdapter): ToolDefinition;
+//# sourceMappingURL=activity.d.ts.map

package/dist/adapters/mysql/tools/sysschema/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/mysql/tools/sysschema/activity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,4BAA4B,CAAC;AAgBjF;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CA4C9E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CA4C9E"}

package/dist/adapters/mysql/tools/sysschema/activity.js

@@ -0,0 +1,107 @@
+/**
+ * MySQL sys Schema Tools - Activity Monitoring
+ *
+ * Tools for monitoring user and host activity.
+ * 2 tools: user_summary, host_summary.
+ */
+import { z } from 'zod';
+// =============================================================================
+// Zod Schemas
+// =============================================================================
+const UserSummarySchema = z.object({
+    user: z.string().optional().describe('Filter by specific user'),
+    limit: z.number().default(20).describe('Maximum number of results')
+});
+const HostSummarySchema = z.object({
+    host: z.string().optional().describe('Filter by specific host'),
+    limit: z.number().default(20).describe('Maximum number of results')
+});
+/**
+ * Get user activity summary
+ */
+export function createSysUserSummaryTool(adapter) {
+    return {
+        name: 'mysql_sys_user_summary',
+        title: 'MySQL User Summary',
+        description: 'Get user activity summary including statements, connections, and latency from sys schema.',
+        group: 'sysschema',
+        inputSchema: UserSummarySchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { user, limit } = UserSummarySchema.parse(params);
+            let query = `
+                SELECT 
+                    user,
+                    statements,
+                    statement_latency,
+                    statement_avg_latency,
+                    table_scans,
+                    file_ios,
+                    file_io_latency,
+                    current_connections,
+                    total_connections
+                FROM sys.user_summary
+            `;
+            const queryParams = [];
+            if (user) {
+                query += ' WHERE user = ?';
+                queryParams.push(user);
+            }
+            query += ` ORDER BY statement_latency DESC LIMIT ${String(limit)}`;
+            const result = await adapter.executeQuery(query, queryParams);
+            return {
+                users: result.rows,
+                count: result.rows?.length ?? 0
+            };
+        }
+    };
+}
+/**
+ * Get host connection summary
+ */
+export function createSysHostSummaryTool(adapter) {
+    return {
+        name: 'mysql_sys_host_summary',
+        title: 'MySQL Host Summary',
+        description: 'Get connection and activity summary by host from sys schema.',
+        group: 'sysschema',
+        inputSchema: HostSummarySchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { host, limit } = HostSummarySchema.parse(params);
+            let query = `
+                SELECT 
+                    host,
+                    statements,
+                    statement_latency,
+                    statement_avg_latency,
+                    table_scans,
+                    file_ios,
+                    file_io_latency,
+                    current_connections,
+                    total_connections
+                FROM sys.host_summary
+            `;
+            const queryParams = [];
+            if (host) {
+                query += ' WHERE host = ?';
+                queryParams.push(host);
+            }
+            query += ` ORDER BY statement_latency DESC LIMIT ${String(limit)}`;
+            const result = await adapter.executeQuery(query, queryParams);
+            return {
+                hosts: result.rows,
+                count: result.rows?.length ?? 0
+            };
+        }
+    };
+}
+//# sourceMappingURL=activity.js.map

package/dist/adapters/mysql/tools/sysschema/activity.js.map

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

package/dist/adapters/mysql/tools/sysschema/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * MySQL sys Schema Tools
+ *
+ * Tools for leveraging MySQL's built-in sys schema for diagnostics.
+ * 8 tools total (2 activity + 3 performance + 3 resources).
+ */
+import type { MySQLAdapter } from '../../MySQLAdapter.js';
+import type { ToolDefinition } from '../../../../types/index.js';
+/**
+ * Get all sys schema tools
+ */
+export declare function getSysSchemaTools(adapter: MySQLAdapter): ToolDefinition[];
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/mysql/tools/sysschema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/mysql/tools/sysschema/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAoBjE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,EAAE,CAWzE"}

package/dist/adapters/mysql/tools/sysschema/index.js

@@ -0,0 +1,26 @@
+/**
+ * MySQL sys Schema Tools
+ *
+ * Tools for leveraging MySQL's built-in sys schema for diagnostics.
+ * 8 tools total (2 activity + 3 performance + 3 resources).
+ */
+// Import from submodules
+import { createSysUserSummaryTool, createSysHostSummaryTool } from './activity.js';
+import { createSysStatementSummaryTool, createSysWaitSummaryTool, createSysIOSummaryTool } from './performance.js';
+import { createSysSchemaStatsTool, createSysInnoDBLockWaitsTool, createSysMemorySummaryTool } from './resources.js';
+/**
+ * Get all sys schema tools
+ */
+export function getSysSchemaTools(adapter) {
+    return [
+        createSysUserSummaryTool(adapter),
+        createSysIOSummaryTool(adapter),
+        createSysStatementSummaryTool(adapter),
+        createSysWaitSummaryTool(adapter),
+        createSysInnoDBLockWaitsTool(adapter),
+        createSysSchemaStatsTool(adapter),
+        createSysHostSummaryTool(adapter),
+        createSysMemorySummaryTool(adapter)
+    ];
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/mysql/tools/sysschema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/adapters/mysql/tools/sysschema/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,yBAAyB;AACzB,OAAO,EACH,wBAAwB,EACxB,wBAAwB,EAC3B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACH,6BAA6B,EAC7B,wBAAwB,EACxB,sBAAsB,EACzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACH,wBAAwB,EACxB,4BAA4B,EAC5B,0BAA0B,EAC7B,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAqB;IACnD,OAAO;QACH,wBAAwB,CAAC,OAAO,CAAC;QACjC,sBAAsB,CAAC,OAAO,CAAC;QAC/B,6BAA6B,CAAC,OAAO,CAAC;QACtC,wBAAwB,CAAC,OAAO,CAAC;QACjC,4BAA4B,CAAC,OAAO,CAAC;QACrC,wBAAwB,CAAC,OAAO,CAAC;QACjC,wBAAwB,CAAC,OAAO,CAAC;QACjC,0BAA0B,CAAC,OAAO,CAAC;KACtC,CAAC;AACN,CAAC"}