@neverinfamous/mysql-mcp 2.3.0 → 3.0.0

package/dist/adapters/mysql/types.js

@@ -300,7 +300,7 @@ export const DropTableSchemaBase = z.object({
     ifExists: z
         .boolean()
         .optional()
-        .default(true)
+        .default(false)
         .describe("Add IF EXISTS clause"),
 });
 // Transformed schema for handler parsing
@@ -364,6 +364,11 @@ export const GetIndexesSchema = z
 // Transaction Schemas
 // =============================================================================
 // --- TransactionBegin ---
+// Base schema for MCP visibility
+export const TransactionBeginSchemaBase = z.object({
+    isolationLevel: z.string().optional().describe("Transaction isolation level"),
+});
+// Transformed schema for handler parsing
 export const TransactionBeginSchema = z.preprocess(defaultToEmpty, z.object({
     isolationLevel: z
         .enum([
@@ -421,23 +426,27 @@ export const TransactionExecuteSchemaBase = z.object({
         .optional()
         .describe("SQL statements to execute atomically"),
     queries: z.array(z.string()).optional().describe("Alias for statements"),
-    isolationLevel: z
-        .enum([
-        "READ UNCOMMITTED",
-        "READ COMMITTED",
-        "REPEATABLE READ",
-        "SERIALIZABLE",
-    ])
-        .optional()
-        .describe("Transaction isolation level"),
+    isolationLevel: z.string().optional().describe("Transaction isolation level"),
 });
-// Transformed schema for handler parsing
 export const TransactionExecuteSchema = z
     .preprocess(preprocessTransactionExecuteParams, TransactionExecuteSchemaBase)
     .transform((data) => ({
     statements: data.statements ?? data.queries ?? [],
     isolationLevel: data.isolationLevel,
-}));
+}))
+    .refine((data) => {
+    if (!data.isolationLevel)
+        return true;
+    const validLevels = [
+        "READ UNCOMMITTED",
+        "READ COMMITTED",
+        "REPEATABLE READ",
+        "SERIALIZABLE",
+    ];
+    return validLevels.includes(data.isolationLevel);
+}, {
+    message: "Invalid isolationLevel. Expected one of: READ UNCOMMITTED, READ COMMITTED, REPEATABLE READ, SERIALIZABLE",
+});
 // =============================================================================
 // Preprocess: JSON/Text column params (table, column, where aliases)
 // =============================================================================
@@ -635,6 +644,333 @@ export const JsonSearchSchema = z
     .refine((data) => data.column !== "", {
     message: "column (or col alias) is required",
 });
+// --- JsonInsert ---
+export const JsonInsertSchemaBase = z.object({
+    table: z.string().optional().describe("Table name"),
+    tableName: z.string().optional().describe("Alias for table"),
+    name: z.string().optional().describe("Alias for table"),
+    column: z.string().optional().describe("JSON column name"),
+    col: z.string().optional().describe("Alias for column"),
+    path: z.string().describe("JSON path to insert at"),
+    value: z.unknown().describe("Value to insert"),
+    where: z.string().optional().describe("WHERE clause to identify rows"),
+    filter: z.string().optional().describe("Alias for where"),
+});
+export const JsonInsertSchema = z
+    .preprocess(preprocessJsonColumnParams, z.object({
+    table: z.string().optional(),
+    tableName: z.string().optional(),
+    name: z.string().optional(),
+    column: z.string().optional(),
+    col: z.string().optional(),
+    path: z.string(),
+    value: z.unknown(),
+    where: z.string().optional(),
+    filter: z.string().optional(),
+}))
+    .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    column: data.column ?? data.col ?? "",
+    path: data.path,
+    value: data.value,
+    where: data.where ?? data.filter ?? "",
+}))
+    .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+})
+    .refine((data) => data.column !== "", {
+    message: "column (or col alias) is required",
+})
+    .refine((data) => data.where !== "", {
+    message: "where (or filter alias) is required",
+});
+// --- JsonReplace ---
+export const JsonReplaceSchemaBase = z.object({
+    table: z.string().optional().describe("Table name"),
+    tableName: z.string().optional().describe("Alias for table"),
+    name: z.string().optional().describe("Alias for table"),
+    column: z.string().optional().describe("JSON column name"),
+    col: z.string().optional().describe("Alias for column"),
+    path: z.string().describe("JSON path to replace"),
+    value: z.unknown().describe("Replacement value"),
+    where: z.string().optional().describe("WHERE clause to identify rows"),
+    filter: z.string().optional().describe("Alias for where"),
+});
+export const JsonReplaceSchema = z
+    .preprocess(preprocessJsonColumnParams, z.object({
+    table: z.string().optional(),
+    tableName: z.string().optional(),
+    name: z.string().optional(),
+    column: z.string().optional(),
+    col: z.string().optional(),
+    path: z.string(),
+    value: z.unknown(),
+    where: z.string().optional(),
+    filter: z.string().optional(),
+}))
+    .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    column: data.column ?? data.col ?? "",
+    path: data.path,
+    value: data.value,
+    where: data.where ?? data.filter ?? "",
+}))
+    .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+})
+    .refine((data) => data.column !== "", {
+    message: "column (or col alias) is required",
+})
+    .refine((data) => data.where !== "", {
+    message: "where (or filter alias) is required",
+});
+// --- JsonRemove ---
+export const JsonRemoveSchemaBase = z.object({
+    table: z.string().optional().describe("Table name"),
+    tableName: z.string().optional().describe("Alias for table"),
+    name: z.string().optional().describe("Alias for table"),
+    column: z.string().optional().describe("JSON column name"),
+    col: z.string().optional().describe("Alias for column"),
+    paths: z.array(z.string()).describe("JSON paths to remove"),
+    where: z.string().optional().describe("WHERE clause to identify rows"),
+    filter: z.string().optional().describe("Alias for where"),
+});
+export const JsonRemoveSchema = z
+    .preprocess(preprocessJsonColumnParams, z.object({
+    table: z.string().optional(),
+    tableName: z.string().optional(),
+    name: z.string().optional(),
+    column: z.string().optional(),
+    col: z.string().optional(),
+    paths: z.array(z.string()),
+    where: z.string().optional(),
+    filter: z.string().optional(),
+}))
+    .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    column: data.column ?? data.col ?? "",
+    paths: data.paths,
+    where: data.where ?? data.filter ?? "",
+}))
+    .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+})
+    .refine((data) => data.column !== "", {
+    message: "column (or col alias) is required",
+})
+    .refine((data) => data.where !== "", {
+    message: "where (or filter alias) is required",
+});
+// --- JsonArrayAppend ---
+export const JsonArrayAppendSchemaBase = z.object({
+    table: z.string().optional().describe("Table name"),
+    tableName: z.string().optional().describe("Alias for table"),
+    name: z.string().optional().describe("Alias for table"),
+    column: z.string().optional().describe("JSON column name"),
+    col: z.string().optional().describe("Alias for column"),
+    path: z.string().describe("JSON path to array"),
+    value: z.unknown().describe("Value to append"),
+    where: z.string().optional().describe("WHERE clause to identify rows"),
+    filter: z.string().optional().describe("Alias for where"),
+});
+export const JsonArrayAppendSchema = z
+    .preprocess(preprocessJsonColumnParams, z.object({
+    table: z.string().optional(),
+    tableName: z.string().optional(),
+    name: z.string().optional(),
+    column: z.string().optional(),
+    col: z.string().optional(),
+    path: z.string(),
+    value: z.unknown(),
+    where: z.string().optional(),
+    filter: z.string().optional(),
+}))
+    .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    column: data.column ?? data.col ?? "",
+    path: data.path,
+    value: data.value,
+    where: data.where ?? data.filter ?? "",
+}))
+    .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+})
+    .refine((data) => data.column !== "", {
+    message: "column (or col alias) is required",
+})
+    .refine((data) => data.where !== "", {
+    message: "where (or filter alias) is required",
+});
+// --- JsonGet ---
+export const JsonGetSchemaBase = z.object({
+    table: z.string().optional().describe("Table name"),
+    tableName: z.string().optional().describe("Alias for table"),
+    name: z.string().optional().describe("Alias for table"),
+    column: z.string().optional().describe("JSON column name"),
+    col: z.string().optional().describe("Alias for column"),
+    path: z.string().describe("JSON path to extract"),
+    id: z.union([z.string(), z.number()]).describe("Row ID"),
+    idColumn: z.string().default("id").describe("ID column name"),
+});
+export const JsonGetSchema = z
+    .preprocess(preprocessJsonColumnParams, z.object({
+    table: z.string().optional(),
+    tableName: z.string().optional(),
+    name: z.string().optional(),
+    column: z.string().optional(),
+    col: z.string().optional(),
+    path: z.string(),
+    id: z.union([z.string(), z.number()]),
+    idColumn: z.string().default("id"),
+}))
+    .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    column: data.column ?? data.col ?? "",
+    path: data.path,
+    id: data.id,
+    idColumn: data.idColumn,
+}))
+    .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+})
+    .refine((data) => data.column !== "", {
+    message: "column (or col alias) is required",
+});
+// --- JsonUpdate ---
+export const JsonUpdateSchemaBase = z.object({
+    table: z.string().optional().describe("Table name"),
+    tableName: z.string().optional().describe("Alias for table"),
+    name: z.string().optional().describe("Alias for table"),
+    column: z.string().optional().describe("JSON column name"),
+    col: z.string().optional().describe("Alias for column"),
+    path: z.string().describe("JSON path to update"),
+    value: z.unknown().describe("New value"),
+    id: z.union([z.string(), z.number()]).describe("Row ID"),
+    idColumn: z.string().default("id").describe("ID column name"),
+});
+export const JsonUpdateSchema = z
+    .preprocess(preprocessJsonColumnParams, z.object({
+    table: z.string().optional(),
+    tableName: z.string().optional(),
+    name: z.string().optional(),
+    column: z.string().optional(),
+    col: z.string().optional(),
+    path: z.string(),
+    value: z.unknown(),
+    id: z.union([z.string(), z.number()]),
+    idColumn: z.string().default("id"),
+}))
+    .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    column: data.column ?? data.col ?? "",
+    path: data.path,
+    value: data.value,
+    id: data.id,
+    idColumn: data.idColumn,
+}))
+    .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+})
+    .refine((data) => data.column !== "", {
+    message: "column (or col alias) is required",
+});
+// --- JsonNormalize ---
+export const JsonNormalizeSchemaBase = z.object({
+    table: z.string().optional().describe("Table name"),
+    tableName: z.string().optional().describe("Alias for table"),
+    name: z.string().optional().describe("Alias for table"),
+    column: z.string().optional().describe("JSON column name"),
+    col: z.string().optional().describe("Alias for column"),
+    where: z.string().optional().describe("WHERE clause"),
+    filter: z.string().optional().describe("Alias for where"),
+    limit: z.number().default(100).describe("Maximum rows to process"),
+});
+export const JsonNormalizeSchema = z
+    .preprocess(preprocessJsonColumnParams, z.object({
+    table: z.string().optional(),
+    tableName: z.string().optional(),
+    name: z.string().optional(),
+    column: z.string().optional(),
+    col: z.string().optional(),
+    where: z.string().optional(),
+    filter: z.string().optional(),
+    limit: z.number().default(100),
+}))
+    .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    column: data.column ?? data.col ?? "",
+    where: data.where ?? data.filter,
+    limit: data.limit,
+}))
+    .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+})
+    .refine((data) => data.column !== "", {
+    message: "column (or col alias) is required",
+});
+// --- JsonStats ---
+export const JsonStatsSchemaBase = z.object({
+    table: z.string().optional().describe("Table name"),
+    tableName: z.string().optional().describe("Alias for table"),
+    name: z.string().optional().describe("Alias for table"),
+    column: z.string().optional().describe("JSON column name"),
+    col: z.string().optional().describe("Alias for column"),
+    where: z.string().optional().describe("Optional WHERE clause"),
+    filter: z.string().optional().describe("Alias for where"),
+    sampleSize: z.number().default(1000).describe("Sample size for statistics"),
+});
+export const JsonStatsSchema = z
+    .preprocess(preprocessJsonColumnParams, z.object({
+    table: z.string().optional(),
+    tableName: z.string().optional(),
+    name: z.string().optional(),
+    column: z.string().optional(),
+    col: z.string().optional(),
+    where: z.string().optional(),
+    filter: z.string().optional(),
+    sampleSize: z.number().default(1000),
+}))
+    .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    column: data.column ?? data.col ?? "",
+    where: data.where ?? data.filter,
+    sampleSize: data.sampleSize,
+}))
+    .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+})
+    .refine((data) => data.column !== "", {
+    message: "column (or col alias) is required",
+});
+// --- JsonIndexSuggest ---
+export const JsonIndexSuggestSchemaBase = z.object({
+    table: z.string().optional().describe("Table name"),
+    tableName: z.string().optional().describe("Alias for table"),
+    name: z.string().optional().describe("Alias for table"),
+    column: z.string().optional().describe("JSON column name"),
+    col: z.string().optional().describe("Alias for column"),
+    sampleSize: z.number().default(100).describe("Sample size to analyze"),
+});
+export const JsonIndexSuggestSchema = z
+    .preprocess(preprocessJsonColumnParams, z.object({
+    table: z.string().optional(),
+    tableName: z.string().optional(),
+    name: z.string().optional(),
+    column: z.string().optional(),
+    col: z.string().optional(),
+    sampleSize: z.number().default(100),
+}))
+    .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    column: data.column ?? data.col ?? "",
+    sampleSize: data.sampleSize,
+}))
+    .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+})
+    .refine((data) => data.column !== "", {
+    message: "column (or col alias) is required",
+});
 // --- JsonValidate (no table/column — no aliases needed) ---
 export const JsonValidateSchema = z.object({
     value: z.string().describe("JSON string to validate"),
@@ -951,6 +1287,100 @@ export const FulltextSearchSchema = z
     .refine((data) => data.query !== "", {
     message: "query (or sql alias) is required",
 });
+// --- FulltextDrop ---
+export const FulltextDropSchemaBase = z.object({
+    table: z.string().optional().describe("Table containing the index"),
+    tableName: z.string().optional().describe("Alias for table"),
+    name: z.string().optional().describe("Alias for table"),
+    indexName: z
+        .string()
+        .optional()
+        .describe("Name of the FULLTEXT index to drop"),
+});
+export const FulltextDropSchema = z
+    .preprocess(preprocessTableParams, z.object({
+    table: z.string().optional(),
+    tableName: z.string().optional(),
+    name: z.string().optional(),
+    indexName: z.string().optional(),
+}))
+    .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    indexName: data.indexName ?? "",
+}))
+    .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+})
+    .refine((data) => data.indexName !== "", {
+    message: "indexName is required",
+});
+// --- FulltextBoolean ---
+export const FulltextBooleanSchemaBase = z.object({
+    table: z.string().optional().describe("Table name"),
+    tableName: z.string().optional().describe("Alias for table"),
+    name: z.string().optional().describe("Alias for table"),
+    columns: z.array(z.string()).optional().describe("Columns to search"),
+    query: z
+        .string()
+        .optional()
+        .describe("Boolean search query with +, -, *, etc."),
+    maxLength: z
+        .number()
+        .optional()
+        .describe("Optional max characters per text column in results. Truncates with '...' if exceeded."),
+});
+export const FulltextBooleanSchema = z
+    .preprocess(preprocessTableParams, z.object({
+    table: z.string().optional(),
+    tableName: z.string().optional(),
+    name: z.string().optional(),
+    columns: z.array(z.string()).optional(),
+    query: z.string().optional(),
+    maxLength: z.number().optional(),
+}))
+    .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    columns: data.columns ?? [],
+    query: data.query ?? "",
+    maxLength: data.maxLength,
+}))
+    .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+})
+    .refine((data) => data.columns.length > 0, { message: "columns is required" })
+    .refine((data) => data.query !== "", { message: "query is required" });
+// --- FulltextExpand ---
+export const FulltextExpandSchemaBase = z.object({
+    table: z.string().optional().describe("Table name"),
+    tableName: z.string().optional().describe("Alias for table"),
+    name: z.string().optional().describe("Alias for table"),
+    columns: z.array(z.string()).optional().describe("Columns to search"),
+    query: z.string().optional().describe("Search query to expand"),
+    maxLength: z
+        .number()
+        .optional()
+        .describe("Optional max characters per text column in results. Truncates with '...' if exceeded."),
+});
+export const FulltextExpandSchema = z
+    .preprocess(preprocessTableParams, z.object({
+    table: z.string().optional(),
+    tableName: z.string().optional(),
+    name: z.string().optional(),
+    columns: z.array(z.string()).optional(),
+    query: z.string().optional(),
+    maxLength: z.number().optional(),
+}))
+    .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    columns: data.columns ?? [],
+    query: data.query ?? "",
+    maxLength: data.maxLength,
+}))
+    .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+})
+    .refine((data) => data.columns.length > 0, { message: "columns is required" })
+    .refine((data) => data.query !== "", { message: "query is required" });
 // =============================================================================
 // Performance Schemas
 // =============================================================================
@@ -1012,6 +1442,19 @@ export const SlowQuerySchema = z.object({
         .describe("Number of slow queries to return"),
     minTime: z.number().optional().describe("Minimum query time in seconds"),
 });
+// --- QueryStats (no table/query aliases — simple passthrough) ---
+export const QueryStatsSchema = z.object({
+    orderBy: z
+        .enum(["total_time", "avg_time", "executions"])
+        .optional()
+        .default("total_time")
+        .describe("Order results by metric"),
+    limit: z
+        .number()
+        .optional()
+        .default(10)
+        .describe("Maximum number of queries to return"),
+});
 // --- IndexUsage ---
 export const IndexUsageSchemaBase = z.object({
     table: z.string().optional().describe("Filter by table name"),
@@ -1054,6 +1497,42 @@ export const TableStatsSchema = z
     .refine((data) => data.table !== "", {
     message: "table (or tableName/name alias) is required",
 });
+// --- IndexRecommendation ---
+// Base schema for MCP visibility
+export const IndexRecommendationSchemaBase = z.object({
+    table: z.string().optional().describe("Table to analyze for missing indexes"),
+    tableName: z.string().optional().describe("Alias for table"),
+    name: z.string().optional().describe("Alias for table"),
+});
+// Transformed schema for handler parsing
+export const IndexRecommendationSchema = z
+    .preprocess(preprocessTableParams, IndexRecommendationSchemaBase)
+    .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+}))
+    .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+});
+// --- ForceIndex ---
+// Base schema for MCP visibility
+export const ForceIndexSchemaBase = z.object({
+    table: z.string().optional().describe("Table name"),
+    tableName: z.string().optional().describe("Alias for table"),
+    name: z.string().optional().describe("Alias for table"),
+    query: z.string().describe("Original query"),
+    indexName: z.string().describe("Index name to force"),
+});
+// Transformed schema for handler parsing
+export const ForceIndexSchema = z
+    .preprocess(preprocessTableParams, ForceIndexSchemaBase)
+    .transform((data) => ({
+    table: data.table ?? data.tableName ?? data.name ?? "",
+    query: data.query,
+    indexName: data.indexName,
+}))
+    .refine((data) => data.table !== "", {
+    message: "table (or tableName/name alias) is required",
+});
 // =============================================================================
 // Preprocess: Admin table params (normalizes singular 'table' to 'tables' array)
 // =============================================================================
@@ -1123,10 +1602,7 @@ export const CheckTableSchemaBase = z.object({
     table: z.string().optional().describe("Single table name (alias for tables)"),
     tableName: z.string().optional().describe("Alias for table"),
     name: z.string().optional().describe("Alias for table"),
-    option: z
-        .enum(["QUICK", "FAST", "MEDIUM", "EXTENDED", "CHANGED"])
-        .optional()
-        .describe("Check option"),
+    option: z.string().optional().describe("Check option"),
 });
 export const CheckTableSchema = z
     .preprocess(preprocessAdminTableParams, z.object({
@@ -1145,6 +1621,33 @@ export const CheckTableSchema = z
     .refine((data) => data.tables.length > 0, {
     message: "tables (or table/tableName/name alias) is required",
 });
+// --- RepairTable ---
+export const RepairTableSchemaBase = z.object({
+    tables: z.array(z.string()).optional().describe("Table names to repair"),
+    table: z.string().optional().describe("Single table name (alias for tables)"),
+    tableName: z.string().optional().describe("Alias for table"),
+    name: z.string().optional().describe("Alias for table"),
+    quick: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Quick repair (MyISAM only)"),
+});
+export const RepairTableSchema = z
+    .preprocess(preprocessAdminTableParams, z.object({
+    tables: z.array(z.string()).optional(),
+    table: z.string().optional(),
+    tableName: z.string().optional(),
+    name: z.string().optional(),
+    quick: z.boolean().optional().default(false),
+}))
+    .transform((data) => ({
+    tables: data.tables ?? [],
+    quick: data.quick,
+}))
+    .refine((data) => data.tables.length > 0, {
+    message: "tables (or table/tableName/name alias) is required",
+});
 // --- FlushTables ---
 export const FlushTablesSchemaBase = z.object({
     tables: z
@@ -1165,6 +1668,14 @@ export const FlushTablesSchema = z
     .transform((data) => ({
     tables: data.tables,
 }));
+export const KillQuerySchemaBase = z.object({
+    processId: z.number().describe("Process ID to kill"),
+    connection: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Kill connection instead of query"),
+});
 export const KillQuerySchema = z.object({
     processId: z.number().describe("Process ID to kill"),
     connection: z
@@ -1182,7 +1693,6 @@ export const ShowStatusSchema = z.object({
     limit: z
         .number()
         .int()
-        .positive()
         .optional()
         .describe("Maximum number of variables to return (default: 100). Set higher to see all."),
 });
@@ -1196,7 +1706,6 @@ export const ShowVariablesSchema = z.object({
     limit: z
         .number()
         .int()
-        .positive()
         .optional()
         .describe("Maximum number of variables to return (default: 100). Set higher to see all."),
 });
@@ -1218,10 +1727,16 @@ export const ExportTableSchemaBase = z.object({
     limit: z
         .number()
         .int()
-        .positive()
         .optional()
         .default(100)
         .describe("Maximum number of rows to export (default: 100). Set higher to export more rows."),
+    batch: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .default(1)
+        .describe("Rows per INSERT statement (default: 1). Higher values produce multi-row INSERT ... VALUES (...), (...) for smaller payloads."),
 });
 export const ExportTableSchema = z
     .preprocess(preprocessTableParams, z.object({
@@ -1232,12 +1747,14 @@ export const ExportTableSchema = z
     where: z.string().optional(),
     filter: z.string().optional(),
     limit: z.number().int().positive().optional().default(100),
+    batch: z.number().int().positive().optional().default(1),
 }))
     .transform((data) => ({
     table: data.table ?? data.tableName ?? data.name ?? "",
     format: data.format,
     where: data.where ?? data.filter,
     limit: data.limit,
+    batch: data.batch,
 }))
     .refine((data) => data.table !== "", {
     message: "table (or tableName/name alias) is required",
@@ -1268,11 +1785,21 @@ export const ImportDataSchema = z
 // =============================================================================
 // Replication Schemas
 // =============================================================================
+export const BinlogEventsSchemaBase = z.object({
+    logFile: z.string().optional().describe("Binlog file name"),
+    position: z.number().optional().describe("Starting position"),
+    limit: z
+        .number()
+        .optional()
+        .default(20)
+        .describe("Maximum events to return (default: 20). Set higher for more events."),
+});
 export const BinlogEventsSchema = z.object({
     logFile: z.string().optional().describe("Binlog file name"),
     position: z.number().optional().describe("Starting position"),
     limit: z
         .number()
+        .nonnegative()
         .optional()
         .default(20)
         .describe("Maximum events to return (default: 20). Set higher for more events."),