@neverinfamous/postgres-mcp 1.0.1

package/dist/adapters/postgresql/tools/cron.js

@@ -0,0 +1,440 @@
+/**
+ * PostgreSQL pg_cron Extension Tools
+ *
+ * Job scheduling and management using pg_cron.
+ * 8 tools total.
+ *
+ * pg_cron enables scheduling of SQL commands using familiar cron syntax.
+ * Supports standard cron (minute granularity) and interval scheduling.
+ */
+import { z } from "zod";
+import { readOnly, write, destructive } from "../../../utils/annotations.js";
+import { getToolIcons } from "../../../utils/icons.js";
+import { CronScheduleSchema, CronScheduleSchemaBase, CronScheduleInDatabaseSchema, CronScheduleInDatabaseSchemaBase, CronAlterJobSchema, CronUnscheduleSchema, CronJobRunDetailsSchema, CronCleanupHistorySchema, CronCleanupHistorySchemaBase, } from "../schemas/index.js";
+/**
+ * Get all pg_cron tools
+ */
+export function getCronTools(adapter) {
+    return [
+        createCronExtensionTool(adapter),
+        createCronScheduleTool(adapter),
+        createCronScheduleInDatabaseTool(adapter),
+        createCronUnscheduleTool(adapter),
+        createCronAlterJobTool(adapter),
+        createCronListJobsTool(adapter),
+        createCronJobRunDetailsTool(adapter),
+        createCronCleanupHistoryTool(adapter),
+    ];
+}
+/**
+ * Enable the pg_cron extension
+ */
+function createCronExtensionTool(adapter) {
+    return {
+        name: "pg_cron_create_extension",
+        description: "Enable the pg_cron extension for job scheduling. Requires superuser privileges.",
+        group: "cron",
+        inputSchema: z.object({}),
+        annotations: write("Create Cron Extension"),
+        icons: getToolIcons("cron", write("Create Cron Extension")),
+        handler: async (_params, _context) => {
+            await adapter.executeQuery("CREATE EXTENSION IF NOT EXISTS pg_cron");
+            return { success: true, message: "pg_cron extension enabled" };
+        },
+    };
+}
+/**
+ * Schedule a new cron job
+ */
+function createCronScheduleTool(adapter) {
+    return {
+        name: "pg_cron_schedule",
+        description: `Schedule a new cron job. Supports standard cron syntax (e.g., "0 2 * * *" for 2 AM daily) 
+or interval syntax (e.g., "30 seconds"). Note: pg_cron allows duplicate job names; use unique names to avoid confusion. Returns the job ID.`,
+        group: "cron",
+        // Use base schema for MCP so properties are properly exposed
+        inputSchema: CronScheduleSchemaBase,
+        annotations: write("Schedule Cron Job"),
+        icons: getToolIcons("cron", write("Schedule Cron Job")),
+        handler: async (params, _context) => {
+            // Use transformed schema with alias resolution for validation
+            const { schedule, command, jobName } = CronScheduleSchema.parse(params);
+            let sql;
+            let queryParams;
+            if (jobName !== undefined) {
+                sql = "SELECT cron.schedule($1, $2, $3) as jobid";
+                queryParams = [jobName, schedule, command];
+            }
+            else {
+                sql = "SELECT cron.schedule($1, $2) as jobid";
+                queryParams = [schedule, command];
+            }
+            const result = await adapter.executeQuery(sql, queryParams);
+            const jobId = result.rows?.[0]?.["jobid"];
+            return {
+                success: true,
+                jobId,
+                jobName: jobName ?? null,
+                schedule,
+                command,
+                message: `Job scheduled with ID ${String(jobId)}`,
+                hint: jobName
+                    ? "Use pg_cron_list_jobs to verify job was created with expected name"
+                    : undefined,
+            };
+        },
+    };
+}
+/**
+ * Schedule a job in a different database
+ */
+function createCronScheduleInDatabaseTool(adapter) {
+    return {
+        name: "pg_cron_schedule_in_database",
+        description: `Schedule a cron job to run in a different database. Useful for cross-database 
+maintenance tasks. Returns the job ID.`,
+        group: "cron",
+        // Use base schema for MCP so properties are properly exposed
+        inputSchema: CronScheduleInDatabaseSchemaBase,
+        annotations: write("Schedule Cron in Database"),
+        icons: getToolIcons("cron", write("Schedule Cron in Database")),
+        handler: async (params, _context) => {
+            // Use transformed schema with alias resolution for validation
+            const { jobName, schedule, command, database, username, active } = CronScheduleInDatabaseSchema.parse(params);
+            const activeVal = active ?? true;
+            const sql = `SELECT cron.schedule_in_database($1, $2, $3, $4, $5, $6) as jobid`;
+            const queryParams = [
+                jobName,
+                schedule,
+                command,
+                database,
+                username ?? null,
+                activeVal,
+            ];
+            const result = await adapter.executeQuery(sql, queryParams);
+            const jobId = result.rows?.[0]?.["jobid"];
+            return {
+                success: true,
+                jobId,
+                jobName,
+                schedule,
+                command,
+                database,
+                username: username ?? null,
+                active: activeVal,
+                message: `Job scheduled in database '${database}' with ID ${String(jobId)}`,
+            };
+        },
+    };
+}
+/**
+ * Remove a scheduled job
+ */
+function createCronUnscheduleTool(adapter) {
+    return {
+        name: "pg_cron_unschedule",
+        description: "Remove a scheduled cron job by its ID or name. If both are provided, jobName takes precedence. Job ID accepts numbers or numeric strings. Works for both active and inactive jobs.",
+        group: "cron",
+        inputSchema: CronUnscheduleSchema,
+        annotations: destructive("Unschedule Cron Job"),
+        icons: getToolIcons("cron", destructive("Unschedule Cron Job")),
+        handler: async (params, _context) => {
+            const parsed = CronUnscheduleSchema.parse(params);
+            // Prefer jobName over jobId when both provided
+            const useJobName = parsed.jobName !== undefined;
+            const warning = parsed.jobId !== undefined && parsed.jobName !== undefined
+                ? "Both jobId and jobName provided; using jobName"
+                : undefined;
+            // Look up job info before deletion to return complete response
+            let jobInfo = null;
+            try {
+                const lookupSql = useJobName
+                    ? "SELECT jobid, jobname FROM cron.job WHERE jobname = $1"
+                    : "SELECT jobid, jobname FROM cron.job WHERE jobid = $1::bigint";
+                const lookupResult = await adapter.executeQuery(lookupSql, [
+                    useJobName ? parsed.jobName : parsed.jobId,
+                ]);
+                if (lookupResult.rows && lookupResult.rows.length > 0) {
+                    const row = lookupResult.rows[0];
+                    jobInfo = {
+                        jobid: Number(row.jobid),
+                        jobname: row.jobname,
+                    };
+                }
+            }
+            catch {
+                // Lookup failed, continue with unschedule attempt
+            }
+            // Use explicit type casting to ensure correct pg_cron function overload:
+            // - cron.unschedule(bigint) works for both active and inactive jobs
+            // - cron.unschedule(text) only finds active jobs by name
+            let sql;
+            let queryParams;
+            if (useJobName) {
+                sql = "SELECT cron.unschedule($1::text) as removed";
+                queryParams = [parsed.jobName];
+            }
+            else {
+                sql = "SELECT cron.unschedule($1::bigint) as removed";
+                queryParams = [parsed.jobId];
+            }
+            const result = await adapter.executeQuery(sql, queryParams);
+            const removed = result.rows?.[0]?.["removed"];
+            // Return complete job info from lookup
+            const resolvedJobId = jobInfo?.jobid ?? parsed.jobId ?? null;
+            const resolvedJobName = jobInfo?.jobname ?? parsed.jobName ?? null;
+            return {
+                success: removed,
+                jobId: resolvedJobId,
+                jobName: resolvedJobName,
+                usedIdentifier: useJobName ? "jobName" : "jobId",
+                warning,
+                message: removed
+                    ? `Job ${resolvedJobId !== null ? `ID ${String(resolvedJobId)}` : `"${String(resolvedJobName)}"`} removed successfully`
+                    : "Job not found",
+            };
+        },
+    };
+}
+/**
+ * Modify an existing job
+ */
+function createCronAlterJobTool(adapter) {
+    return {
+        name: "pg_cron_alter_job",
+        description: `Modify an existing cron job. Can change schedule, command, database, username, 
+or active status. Only specify the parameters you want to change.`,
+        group: "cron",
+        inputSchema: CronAlterJobSchema,
+        annotations: write("Alter Cron Job"),
+        icons: getToolIcons("cron", write("Alter Cron Job")),
+        handler: async (params, _context) => {
+            const { jobId, schedule, command, database, username, active } = CronAlterJobSchema.parse(params);
+            const sql = `SELECT cron.alter_job($1, $2, $3, $4, $5, $6)`;
+            const queryParams = [
+                jobId,
+                schedule ?? null,
+                command ?? null,
+                database ?? null,
+                username ?? null,
+                active ?? null,
+            ];
+            await adapter.executeQuery(sql, queryParams);
+            return {
+                success: true,
+                jobId,
+                changes: {
+                    schedule: schedule ?? undefined,
+                    command: command ?? undefined,
+                    database: database ?? undefined,
+                    username: username ?? undefined,
+                    active: active ?? undefined,
+                },
+                message: `Job ${String(jobId)} updated successfully`,
+            };
+        },
+    };
+}
+/**
+ * List all scheduled jobs
+ */
+function createCronListJobsTool(adapter) {
+    const ListJobsSchema = z.object({
+        active: z.boolean().optional().describe("Filter by active status"),
+        limit: z
+            .number()
+            .optional()
+            .describe("Maximum jobs to return (default: 50, use 0 for all)"),
+    });
+    return {
+        name: "pg_cron_list_jobs",
+        description: "List all scheduled cron jobs. Shows job ID, name, schedule, command, and status. Jobs without names (jobname: null) must be referenced by jobId. Default limit: 50 rows.",
+        group: "cron",
+        inputSchema: ListJobsSchema,
+        annotations: readOnly("List Cron Jobs"),
+        icons: getToolIcons("cron", readOnly("List Cron Jobs")),
+        handler: async (params, _context) => {
+            const parsed = ListJobsSchema.parse(params ?? {});
+            let sql = `
+                SELECT 
+                    jobid,
+                    jobname,
+                    schedule,
+                    command,
+                    nodename,
+                    nodeport,
+                    database,
+                    username,
+                    active
+                FROM cron.job
+            `;
+            const queryParams = [];
+            if (parsed.active !== undefined) {
+                sql += " WHERE active = $1";
+                queryParams.push(parsed.active);
+            }
+            sql += " ORDER BY jobid";
+            // Get total count first if we're limiting
+            const limitVal = parsed.limit === 0 ? null : (parsed.limit ?? 50);
+            let totalCount;
+            if (limitVal !== null) {
+                let countSql = "SELECT COUNT(*)::int as total FROM cron.job";
+                if (parsed.active !== undefined) {
+                    countSql += " WHERE active = $1";
+                }
+                const countResult = await adapter.executeQuery(countSql, parsed.active !== undefined ? [parsed.active] : []);
+                totalCount = countResult.rows?.[0]
+                    ?.total;
+                sql += ` LIMIT ${String(limitVal)}`;
+            }
+            const result = await adapter.executeQuery(sql, queryParams);
+            // Normalize jobid to number (PostgreSQL BIGINT may return as string)
+            const jobs = (result.rows ?? []).map((row) => ({
+                ...row,
+                jobid: row["jobid"] !== null && row["jobid"] !== undefined
+                    ? Number(row["jobid"])
+                    : null,
+            }));
+            // Count unnamed jobs for hint
+            const unnamedCount = jobs.filter((j) => j["jobname"] === null).length;
+            // Determine if results were truncated
+            const truncated = limitVal !== null &&
+                totalCount !== undefined &&
+                jobs.length < totalCount;
+            return {
+                jobs,
+                count: jobs.length,
+                ...(truncated ? { truncated: true, totalCount } : {}),
+                hint: unnamedCount > 0
+                    ? `${String(unnamedCount)} job(s) have no name. Use jobId to reference them with alterJob or unschedule.`
+                    : undefined,
+            };
+        },
+    };
+}
+/**
+ * View job execution history
+ */
+function createCronJobRunDetailsTool(adapter) {
+    return {
+        name: "pg_cron_job_run_details",
+        description: `View execution history for cron jobs. Shows start/end times, status, and return messages. 
+Useful for monitoring and debugging scheduled jobs.`,
+        group: "cron",
+        inputSchema: CronJobRunDetailsSchema,
+        annotations: readOnly("Cron Job Run Details"),
+        icons: getToolIcons("cron", readOnly("Cron Job Run Details")),
+        handler: async (params, _context) => {
+            const { jobId, status, limit } = CronJobRunDetailsSchema.parse(params);
+            const conditions = [];
+            const queryParams = [];
+            let paramIndex = 1;
+            if (jobId !== undefined) {
+                conditions.push(`jobid = $${String(paramIndex++)}`);
+                queryParams.push(jobId);
+            }
+            if (status !== undefined) {
+                conditions.push(`status = $${String(paramIndex++)}`);
+                queryParams.push(status);
+            }
+            const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+            // Handle limit: 0 as "no limit" (return all rows), consistent with other AI-optimized tools
+            const limitVal = limit === 0 ? null : (limit ?? 100);
+            // Get total count for truncation indicator (only needed when limiting)
+            let totalCount;
+            if (limitVal !== null) {
+                const countSql = `SELECT COUNT(*)::int as total FROM cron.job_run_details ${whereClause}`;
+                const countResult = await adapter.executeQuery(countSql, queryParams);
+                totalCount =
+                    countResult.rows?.[0]?.total ?? 0;
+            }
+            const limitClause = limitVal !== null ? `LIMIT ${String(limitVal)}` : "";
+            const sql = `
+                SELECT 
+                    runid,
+                    jobid,
+                    job_pid,
+                    database,
+                    username,
+                    command,
+                    status,
+                    return_message,
+                    start_time,
+                    end_time
+                FROM cron.job_run_details
+                ${whereClause}
+                ORDER BY start_time DESC
+                ${limitClause}
+            `;
+            const result = await adapter.executeQuery(sql, queryParams);
+            // Normalize runid and jobid to numbers (PostgreSQL BIGINT may return as strings)
+            const rows = (result.rows ?? []).map((r) => ({
+                ...r,
+                runid: r["runid"] !== null && r["runid"] !== undefined
+                    ? Number(r["runid"])
+                    : null,
+                jobid: r["jobid"] !== null && r["jobid"] !== undefined
+                    ? Number(r["jobid"])
+                    : null,
+            }));
+            const succeeded = rows.filter((r) => r["status"] === "succeeded").length;
+            const failed = rows.filter((r) => r["status"] === "failed").length;
+            const running = rows.filter((r) => r["status"] === "running").length;
+            // Determine if results were truncated (only when limiting)
+            const truncated = limitVal !== null &&
+                totalCount !== undefined &&
+                rows.length < totalCount;
+            return {
+                runs: rows,
+                count: rows.length,
+                ...(truncated ? { truncated: true, totalCount } : {}),
+                summary: {
+                    succeeded,
+                    failed,
+                    running,
+                },
+            };
+        },
+    };
+}
+/**
+ * Clean up old job run history
+ */
+function createCronCleanupHistoryTool(adapter) {
+    return {
+        name: "pg_cron_cleanup_history",
+        description: `Delete old job run history records. Helps prevent the cron.job_run_details table 
+from growing too large. By default, removes records older than 7 days.`,
+        group: "cron",
+        // Use base schema for MCP visibility
+        inputSchema: CronCleanupHistorySchemaBase,
+        annotations: destructive("Cleanup Cron History"),
+        icons: getToolIcons("cron", destructive("Cleanup Cron History")),
+        handler: async (params, _context) => {
+            // Use transformed schema for validation with alias support
+            const { olderThanDays, jobId } = CronCleanupHistorySchema.parse(params);
+            const days = olderThanDays ?? 7;
+            const conditions = [
+                `end_time < now() - interval '${String(days)} days'`,
+            ];
+            const queryParams = [];
+            if (jobId !== undefined) {
+                conditions.push("jobid = $1");
+                queryParams.push(jobId);
+            }
+            const sql = `
+                DELETE FROM cron.job_run_details
+                WHERE ${conditions.join(" AND ")}
+            `;
+            const result = await adapter.executeQuery(sql, queryParams);
+            return {
+                success: true,
+                deletedCount: result.rowsAffected ?? 0,
+                olderThanDays: days,
+                jobId: jobId ?? null,
+                message: `Deleted ${String(result.rowsAffected ?? 0)} old job run records`,
+            };
+        },
+    };
+}
+//# sourceMappingURL=cron.js.map

package/dist/adapters/postgresql/tools/cron.js.map

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

package/dist/adapters/postgresql/tools/jsonb/advanced.d.ts

@@ -0,0 +1,33 @@
+/**
+ * PostgreSQL JSONB Tools - Advanced Operations
+ *
+ * Advanced JSONB operations including path validation, merge, normalize, diff, index suggestions, security scanning, and statistics.
+ */
+import type { PostgresAdapter } from "../../PostgresAdapter.js";
+import type { ToolDefinition } from "../../../../types/index.js";
+/**
+ * Validate JSON path expression
+ */
+export declare function createJsonbValidatePathTool(adapter: PostgresAdapter): ToolDefinition;
+/**
+ * Deep merge two JSONB documents
+ */
+export declare function createJsonbMergeTool(adapter: PostgresAdapter): ToolDefinition;
+/**
+ * Normalize JSONB to relational form (key-value pairs)
+ */
+export declare function createJsonbNormalizeTool(adapter: PostgresAdapter): ToolDefinition;
+export declare function createJsonbDiffTool(adapter: PostgresAdapter): ToolDefinition;
+/**
+ * Suggest JSONB indexes based on query patterns
+ */
+export declare function createJsonbIndexSuggestTool(adapter: PostgresAdapter): ToolDefinition;
+/**
+ * Scan JSONB for security issues
+ */
+export declare function createJsonbSecurityScanTool(adapter: PostgresAdapter): ToolDefinition;
+/**
+ * Get JSONB column statistics
+ */
+export declare function createJsonbStatsTool(adapter: PostgresAdapter): ToolDefinition;
+//# sourceMappingURL=advanced.d.ts.map

package/dist/adapters/postgresql/tools/jsonb/advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/jsonb/advanced.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,4BAA4B,CAAC;AAiBpC;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,GACvB,cAAc,CAuDhB;AAwHD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAkC7E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,eAAe,GACvB,cAAc,CAuJhB;AAgBD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAmD5E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,GACvB,cAAc,CAuHhB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,GACvB,cAAc,CAqHhB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAuH7E"}