@iflow-mcp/xexr_mcp-libsql 1.1.0

package/dist/tools/describe-table.js

@@ -0,0 +1,165 @@
+import { BaseTool } from '../lib/base-tool.js';
+import { formatPerformanceMetrics } from '../utils/performance.js';
+import { DescribeTableInputSchema } from '../schemas/describe-table.js';
+export class DescribeTableTool extends BaseTool {
+    name = 'describe-table';
+    description = 'Get comprehensive schema information for a specific table including columns, indexes, foreign keys, and constraints. Supports both human-readable and JSON output formats.';
+    inputSchema = DescribeTableInputSchema;
+    async executeImpl(context) {
+        const { tableName, includeIndexes, includeForeignKeys, format } = context.arguments;
+        try {
+            const startTime = Date.now();
+            // Sanitize table name for PRAGMA queries
+            const sanitizedTableName = this.sanitizeTableName(tableName);
+            // First check if table exists
+            const tableExistsQuery = `
+        SELECT name, sql
+        FROM sqlite_master 
+        WHERE type='table' AND name=?
+      `;
+            const tableExistsResult = await context.connection.execute(tableExistsQuery, [
+                sanitizedTableName
+            ]);
+            if (tableExistsResult.rows.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error: Table '${tableName}' does not exist`
+                        }
+                    ],
+                    isError: true
+                };
+            }
+            // Get table schema information
+            const schemaQuery = `PRAGMA table_info("${sanitizedTableName}")`;
+            const schemaResult = await context.connection.execute(schemaQuery);
+            const tableInfo = {
+                name: sanitizedTableName,
+                sql: tableExistsResult.rows[0].sql,
+                columns: schemaResult.rows,
+                indexes: [],
+                foreignKeys: []
+            };
+            // Get table indexes if requested
+            if (includeIndexes) {
+                const indexQuery = `PRAGMA index_list("${sanitizedTableName}")`;
+                const indexResult = await context.connection.execute(indexQuery);
+                for (const index of indexResult.rows) {
+                    const indexInfoQuery = `PRAGMA index_info("${index.name}")`;
+                    const indexInfoResult = await context.connection.execute(indexInfoQuery);
+                    tableInfo.indexes.push({
+                        name: index.name,
+                        unique: index.unique,
+                        origin: index.origin,
+                        partial: index.partial,
+                        columns: indexInfoResult.rows
+                    });
+                }
+            }
+            // Get foreign keys if requested
+            if (includeForeignKeys) {
+                const foreignKeyQuery = `PRAGMA foreign_key_list("${sanitizedTableName}")`;
+                const foreignKeyResult = await context.connection.execute(foreignKeyQuery);
+                tableInfo.foreignKeys = foreignKeyResult.rows;
+            }
+            const executionTime = Date.now() - startTime;
+            const metrics = formatPerformanceMetrics({
+                executionTime
+            });
+            if (format === 'json') {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                table: tableInfo,
+                                metadata: {
+                                    executionTime,
+                                    timestamp: new Date().toISOString()
+                                }
+                            }, null, 2)
+                        }
+                    ]
+                };
+            }
+            // Format as human-readable table
+            let output = `Table: ${sanitizedTableName}\n\n`;
+            // Display CREATE statement if available
+            if (tableInfo.sql) {
+                output += 'CREATE Statement:\n';
+                output += `${tableInfo.sql}\n\n`;
+            }
+            // Display columns
+            output += 'Columns:\n';
+            output += '┌─────────────────┬─────────────────┬─────────┬─────────────┬─────────────┐\n';
+            output += '│ Name            │ Type            │ Not Null│ Default     │ Primary Key │\n';
+            output += '├─────────────────┼─────────────────┼─────────┼─────────────┼─────────────┤\n';
+            for (const row of schemaResult.rows) {
+                const name = String(row.name || '').padEnd(15);
+                const type = String(row.type || '').padEnd(15);
+                const notNull = (row.notnull ? 'YES' : 'NO').padEnd(7);
+                const defaultValue = String(row.dflt_value || '').padEnd(11);
+                const primaryKey = (row.pk ? 'YES' : 'NO').padEnd(11);
+                output += `│ ${name} │ ${type} │ ${notNull} │ ${defaultValue} │ ${primaryKey} │\n`;
+            }
+            output += '└─────────────────┴─────────────────┴─────────┴─────────────┴─────────────┘\n\n';
+            // Display indexes if requested and available
+            if (includeIndexes && tableInfo.indexes.length > 0) {
+                output += 'Indexes:\n';
+                for (const index of tableInfo.indexes) {
+                    const indexRecord = index;
+                    const indexType = indexRecord['unique'] ? 'UNIQUE INDEX' : 'INDEX';
+                    const columns = indexRecord['columns'];
+                    const columnNames = columns.map(col => col['name']).join(', ');
+                    output += `- ${indexRecord['name']} (${indexType}) on (${columnNames})\n`;
+                }
+                output += '\n';
+            }
+            else if (includeIndexes) {
+                output += 'No indexes found.\n\n';
+            }
+            // Display foreign keys if requested and available
+            if (includeForeignKeys && tableInfo.foreignKeys.length > 0) {
+                output += 'Foreign Keys:\n';
+                for (const fk of tableInfo.foreignKeys) {
+                    const fkRecord = fk;
+                    output += `- ${fkRecord['from']} → ${fkRecord['table']}.${fkRecord['to']} (${fkRecord['on_update']}/${fkRecord['on_delete']})\n`;
+                }
+                output += '\n';
+            }
+            else if (includeForeignKeys) {
+                output += 'No foreign keys found.\n\n';
+            }
+            output += `${metrics}`;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: output
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error describing table: ${errorMessage}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+    /**
+     * Sanitize table name for safe use in PRAGMA queries
+     */
+    sanitizeTableName(tableName) {
+        // Remove quotes if present and validate
+        return tableName.replace(/^["'`[]|["'`]]$/g, '');
+    }
+}
+//# sourceMappingURL=describe-table.js.map

package/dist/tools/describe-table.js.map

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

package/dist/tools/list-tables.d.ts

@@ -0,0 +1,32 @@
+import { BaseTool, type ToolExecutionContext, type ToolExecutionResult } from '../lib/base-tool.js';
+export declare class ListTablesTool extends BaseTool {
+    readonly name = "list-tables";
+    readonly description = "List all tables, views, and indexes in the libSQL database with optional filtering and detailed information. Supports multiple output formats and pattern matching.";
+    readonly inputSchema: import("zod").ZodObject<{
+        includeSystemTables: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
+        includeViews: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
+        includeIndexes: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
+        includeDetails: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
+        pattern: import("zod").ZodOptional<import("zod").ZodString>;
+        format: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<["table", "json", "list"]>>>;
+    }, "strip", import("zod").ZodTypeAny, {
+        includeSystemTables: boolean;
+        includeViews: boolean;
+        includeIndexes: boolean;
+        includeDetails: boolean;
+        format: "table" | "json" | "list";
+        pattern?: string | undefined;
+    }, {
+        pattern?: string | undefined;
+        includeSystemTables?: boolean | undefined;
+        includeViews?: boolean | undefined;
+        includeIndexes?: boolean | undefined;
+        includeDetails?: boolean | undefined;
+        format?: "table" | "json" | "list" | undefined;
+    }>;
+    protected executeImpl(context: ToolExecutionContext): Promise<ToolExecutionResult>;
+    private getSchemaObjects;
+    private formatAsTable;
+    private formatAsList;
+}
+//# sourceMappingURL=list-tables.d.ts.map

package/dist/tools/list-tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tables.d.ts","sourceRoot":"","sources":["../../src/tools/list-tables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAIpG,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,yKACoJ;IACxK,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;OAAyB;cAE7B,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;YAqE1E,gBAAgB;IAwE9B,OAAO,CAAC,aAAa;IAyDrB,OAAO,CAAC,YAAY;CA2CrB"}

package/dist/tools/list-tables.js

@@ -0,0 +1,210 @@
+import { BaseTool } from '../lib/base-tool.js';
+import { formatPerformanceMetrics } from '../utils/performance.js';
+import { ListTablesInputSchema } from '../schemas/list-tables.js';
+export class ListTablesTool extends BaseTool {
+    name = 'list-tables';
+    description = 'List all tables, views, and indexes in the libSQL database with optional filtering and detailed information. Supports multiple output formats and pattern matching.';
+    inputSchema = ListTablesInputSchema;
+    async executeImpl(context) {
+        const { includeSystemTables, includeViews, includeIndexes, includeDetails, pattern, format } = context.arguments;
+        try {
+            const startTime = Date.now();
+            // Build the query based on options
+            const objects = await this.getSchemaObjects(context, {
+                includeSystemTables,
+                includeViews,
+                includeIndexes,
+                ...(pattern && { pattern })
+            });
+            const executionTime = Date.now() - startTime;
+            if (format === 'json') {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                objects,
+                                metadata: {
+                                    totalCount: objects.length,
+                                    executionTime,
+                                    timestamp: new Date().toISOString(),
+                                    filters: {
+                                        includeSystemTables,
+                                        includeViews,
+                                        includeIndexes,
+                                        pattern
+                                    }
+                                }
+                            }, null, 2)
+                        }
+                    ]
+                };
+            }
+            const metrics = formatPerformanceMetrics({
+                executionTime,
+                rowsReturned: objects.length
+            });
+            if (format === 'table' || includeDetails) {
+                return this.formatAsTable(objects, metrics);
+            }
+            else {
+                return this.formatAsList(objects, metrics);
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error listing database objects: ${errorMessage}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+    async getSchemaObjects(context, options) {
+        const types = ['table'];
+        if (options.includeViews)
+            types.push('view');
+        if (options.includeIndexes)
+            types.push('index');
+        const whereConditions = [`type IN (${types.map(() => '?').join(', ')})`];
+        const params = [...types];
+        // System tables filter
+        if (!options.includeSystemTables) {
+            whereConditions.push("name NOT LIKE 'sqlite_%'");
+        }
+        // Pattern filter
+        if (options.pattern) {
+            whereConditions.push('name LIKE ?');
+            params.push(options.pattern);
+        }
+        const query = `
+      SELECT name, type, sql
+      FROM sqlite_master 
+      WHERE ${whereConditions.join(' AND ')}
+      ORDER BY type, name
+    `;
+        const result = await context.connection.execute(query, params);
+        const objects = [];
+        for (const row of result.rows) {
+            const rowRecord = row;
+            const obj = {
+                name: rowRecord['name'],
+                type: rowRecord['type'],
+                sql: rowRecord['sql'],
+                rowCount: null,
+                columnCount: null
+            };
+            // Get additional details for tables if requested
+            if (rowRecord['type'] === 'table') {
+                try {
+                    // Get row count
+                    const countQuery = `SELECT COUNT(*) as count FROM "${rowRecord['name']}"`;
+                    const countResult = await context.connection.execute(countQuery);
+                    obj['rowCount'] = countResult.rows[0]?.['count'] || 0;
+                    // Get column count
+                    const columnsQuery = `PRAGMA table_info("${rowRecord['name']}")`;
+                    const columnsResult = await context.connection.execute(columnsQuery);
+                    obj['columnCount'] = columnsResult.rows.length;
+                }
+                catch {
+                    // If we can't get details, continue without them
+                    obj['rowCount'] = null;
+                    obj['columnCount'] = null;
+                }
+            }
+            objects.push(obj);
+        }
+        return objects;
+    }
+    formatAsTable(objects, metrics) {
+        let output = 'Database Schema Objects:\n\n';
+        if (objects.length === 0) {
+            output += 'No objects found matching the criteria.\n';
+        }
+        else {
+            output +=
+                '┌─────────────────────┬─────────┬───────┬─────────┬──────────────────────────────────────┐\n';
+            output +=
+                '│ Name                │ Type    │ Rows  │ Columns │ Description                          │\n';
+            output +=
+                '├─────────────────────┼─────────┼───────┼─────────┼──────────────────────────────────────┤\n';
+            for (const obj of objects) {
+                const name = String(obj['name'] || '').padEnd(19);
+                const type = String(obj['type'] || '').padEnd(7);
+                const rowCount = obj['rowCount'] !== null ? String(obj['rowCount']).padEnd(5) : 'N/A'.padEnd(5);
+                const columnCount = obj['columnCount'] !== null ? String(obj['columnCount']).padEnd(7) : 'N/A'.padEnd(7);
+                // Extract a brief description from SQL
+                let description = '';
+                const sqlValue = obj['sql'];
+                if (sqlValue && typeof sqlValue === 'string') {
+                    const match = sqlValue.match(/CREATE\s+(TABLE|VIEW|INDEX)\s+[^(]+(\([^)]*\))?/i);
+                    if (match) {
+                        description = match[0].replace(/\s+/g, ' ').substring(0, 36);
+                    }
+                }
+                description = description.padEnd(36);
+                output += `│ ${name} │ ${type} │ ${rowCount} │ ${columnCount} │ ${description} │\n`;
+            }
+            output +=
+                '└─────────────────────┴─────────┴───────┴─────────┴──────────────────────────────────────┘\n\n';
+            // Summary
+            const objectArray = objects;
+            const tableCount = objectArray.filter(o => o['type'] === 'table').length;
+            const viewCount = objectArray.filter(o => o['type'] === 'view').length;
+            const indexCount = objectArray.filter(o => o['type'] === 'index').length;
+            output += `Summary: ${tableCount} tables, ${viewCount} views, ${indexCount} indexes\n`;
+        }
+        output += `\n${metrics}`;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: output
+                }
+            ]
+        };
+    }
+    formatAsList(objects, metrics) {
+        let output = 'Database Objects:\n\n';
+        if (objects.length === 0) {
+            output += 'No objects found matching the criteria.\n';
+        }
+        else {
+            const groupedObjects = objects.reduce((acc, obj) => {
+                const type = String(obj['type']);
+                if (!acc[type])
+                    acc[type] = [];
+                acc[type].push(obj);
+                return acc;
+            }, {});
+            for (const [type, items] of Object.entries(groupedObjects)) {
+                const typedItems = items;
+                // Handle proper pluralization
+                const pluralType = type === 'index' ? 'INDEXES' : `${type.toUpperCase()}S`;
+                output += `${pluralType} (${typedItems.length}):\n`;
+                for (const item of typedItems) {
+                    output += `- ${item['name']}`;
+                    if (item['rowCount'] !== null && item['rowCount'] !== undefined) {
+                        output += ` (${item['rowCount']} rows)`;
+                    }
+                    output += '\n';
+                }
+                output += '\n';
+            }
+        }
+        output += `${metrics}`;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: output
+                }
+            ]
+        };
+    }
+}
+//# sourceMappingURL=list-tables.js.map

package/dist/tools/list-tables.js.map

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

package/dist/tools/read-query.d.ts

@@ -0,0 +1,17 @@
+import { BaseTool, type ToolExecutionContext, type ToolExecutionResult } from '../lib/base-tool.js';
+export declare class ReadQueryTool extends BaseTool {
+    readonly name = "read-query";
+    readonly description = "Execute SELECT queries on the libSQL database";
+    readonly inputSchema: import("zod").ZodObject<{
+        query: import("zod").ZodEffects<import("zod").ZodEffects<import("zod").ZodEffects<import("zod").ZodEffects<import("zod").ZodString, string, string>, string, string>, string, string>, string, string>;
+        parameters: import("zod").ZodEffects<import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodUnion<[import("zod").ZodString, import("zod").ZodNumber, import("zod").ZodBoolean, import("zod").ZodNull]>, "many">>>, (string | number | boolean | null)[], (string | number | boolean | null)[] | undefined>;
+    }, "strip", import("zod").ZodTypeAny, {
+        query: string;
+        parameters: (string | number | boolean | null)[];
+    }, {
+        query: string;
+        parameters?: (string | number | boolean | null)[] | undefined;
+    }>;
+    protected executeImpl(context: ToolExecutionContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=read-query.d.ts.map

package/dist/tools/read-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-query.d.ts","sourceRoot":"","sources":["../../src/tools/read-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAMpG,qBAAa,aAAc,SAAQ,QAAQ;IACzC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,mDAAmD;IACvE,QAAQ,CAAC,WAAW;;;;;;;;;OAAwB;cAE5B,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAwHzF"}

package/dist/tools/read-query.js

@@ -0,0 +1,112 @@
+import { BaseTool } from '../lib/base-tool.js';
+import { formatPerformanceMetrics } from '../utils/performance.js';
+import { ReadQueryInputSchema } from '../schemas/read-query.js';
+import { DEFAULT_CONFIG } from '../lib/constants.js';
+export class ReadQueryTool extends BaseTool {
+    name = 'read-query';
+    description = 'Execute SELECT queries on the libSQL database';
+    inputSchema = ReadQueryInputSchema;
+    async executeImpl(context) {
+        const { query, parameters } = context.arguments;
+        try {
+            const startTime = Date.now();
+            // Execute query with timeout handling
+            const result = await Promise.race([
+                parameters && parameters.length > 0
+                    ? context.connection.execute(query, parameters)
+                    : context.connection.execute(query),
+                new Promise((_, reject) => setTimeout(() => reject(new Error(`Query timeout after ${DEFAULT_CONFIG.queryTimeout}ms`)), DEFAULT_CONFIG.queryTimeout))
+            ]);
+            const executionTime = Date.now() - startTime;
+            // Check result size limit
+            if (result.rows.length > DEFAULT_CONFIG.maxResultSize) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error: Query result too large (${result.rows.length} rows, max ${DEFAULT_CONFIG.maxResultSize})`
+                        }
+                    ],
+                    isError: true
+                };
+            }
+            const metrics = formatPerformanceMetrics({
+                executionTime,
+                rowsReturned: result.rows.length
+            });
+            // Format the results
+            let output = 'Query executed successfully\n\n';
+            if (result.rows.length === 0) {
+                output += 'No rows returned.\n';
+            }
+            else {
+                // Format as a table
+                const columns = result.columns || [];
+                output += `Found ${result.rows.length} row(s):\n\n`;
+                if (columns.length > 0) {
+                    // Calculate column widths for better formatting
+                    const columnWidths = columns.map((col) => {
+                        const headerWidth = col.length;
+                        const maxDataWidth = Math.max(...result.rows.slice(0, 100).map((row) => {
+                            const value = row[col];
+                            return value === null ? 4 : String(value).length; // 4 for 'NULL'
+                        }));
+                        return Math.max(headerWidth, maxDataWidth, 3); // Minimum 3 chars
+                    });
+                    // Add column headers with proper spacing
+                    const headerRow = columns.map((col, i) => col.padEnd(columnWidths[i] || 0)).join(' | ');
+                    output += `${headerRow}\n`;
+                    // Add separator
+                    const separator = columnWidths.map((width) => '-'.repeat(width)).join('-+-');
+                    output += `${separator}\n`;
+                    // Add rows (limit to first 100 rows for display)
+                    const displayRows = result.rows.slice(0, 100);
+                    for (const row of displayRows) {
+                        const rowValues = columns.map((col, i) => {
+                            const value = row[col];
+                            const displayValue = value === null ? 'NULL' : String(value);
+                            return displayValue.padEnd(columnWidths[i] || 0);
+                        });
+                        output += `${rowValues.join(' | ')}\n`;
+                    }
+                    if (result.rows.length > 100) {
+                        output += `\n... and ${result.rows.length - 100} more rows (use LIMIT clause to see more)\n`;
+                    }
+                }
+                else {
+                    // Fallback for queries without column metadata
+                    output += JSON.stringify(result.rows.slice(0, 10), null, 2);
+                    if (result.rows.length > 10) {
+                        output += `\n... and ${result.rows.length - 10} more rows\n`;
+                    }
+                }
+            }
+            output += `\nPerformance: ${metrics}`;
+            // Add query info if parameters were used
+            if (parameters && parameters.length > 0) {
+                output += `\nParameters: ${parameters.length} parameter(s) used`;
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: output
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error executing query: ${errorMessage}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+}
+//# sourceMappingURL=read-query.js.map

package/dist/tools/read-query.js.map

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

package/dist/tools/write-query.d.ts

@@ -0,0 +1,20 @@
+import { BaseTool, type ToolExecutionContext, type ToolExecutionResult } from '../lib/base-tool.js';
+export declare class WriteQueryTool extends BaseTool {
+    readonly name = "write-query";
+    readonly description = "Execute INSERT, UPDATE, DELETE queries on the libSQL database. Returns affected row count and performance metrics. Supports parameterized queries for security.";
+    readonly inputSchema: import("zod").ZodObject<{
+        query: import("zod").ZodEffects<import("zod").ZodEffects<import("zod").ZodEffects<import("zod").ZodString, string, string>, string, string>, string, string>;
+        parameters: import("zod").ZodEffects<import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodUnion<[import("zod").ZodString, import("zod").ZodNumber, import("zod").ZodBoolean, import("zod").ZodNull]>, "many">>>, (string | number | boolean | null)[], (string | number | boolean | null)[] | undefined>;
+        useTransaction: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
+    }, "strip", import("zod").ZodTypeAny, {
+        query: string;
+        parameters: (string | number | boolean | null)[];
+        useTransaction: boolean;
+    }, {
+        query: string;
+        parameters?: (string | number | boolean | null)[] | undefined;
+        useTransaction?: boolean | undefined;
+    }>;
+    protected executeImpl(context: ToolExecutionContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=write-query.d.ts.map

package/dist/tools/write-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-query.d.ts","sourceRoot":"","sources":["../../src/tools/write-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAIpG,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,qKACgJ;IACpK,QAAQ,CAAC,WAAW;;;;;;;;;;;;OAAyB;cAE7B,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA6DzF"}