@neverinfamous/postgres-mcp 2.0.0 → 2.1.0

package/dist/codemode/api/group-api.js

@@ -0,0 +1,179 @@
+/**
+ * postgres-mcp - Code Mode Group API Generator
+ *
+ * Dynamic API generator for tool groups. Creates methods for each tool
+ * in the group, wires up method aliases, and adds special wrapper
+ * functions for text (soundex/metaphone) and performance groups.
+ */
+import { METHOD_ALIASES } from "./maps.js";
+import { normalizeParams } from "./normalize.js";
+/**
+ * Dynamic API generator for tool groups
+ * Creates methods for each tool in the group
+ */
+export function createGroupApi(adapter, groupName, tools) {
+    const api = {};
+    for (const tool of tools) {
+        // Convert tool name to method name
+        // e.g., pg_read_query -> readQuery, pg_jsonb_extract -> extract
+        const methodName = toolNameToMethodName(tool.name, groupName);
+        api[methodName] = async (...args) => {
+            // Normalize positional arguments to object parameters
+            // Use empty object when no args provided to match direct tool call behavior
+            const normalizedParams = normalizeParams(methodName, args) ?? {};
+            const context = adapter.createContext();
+            return tool.handler(normalizedParams, context);
+        };
+    }
+    // Add method aliases for this group
+    const aliases = METHOD_ALIASES[groupName];
+    if (aliases !== undefined) {
+        for (const [aliasName, canonicalName] of Object.entries(aliases)) {
+            if (api[canonicalName] !== undefined) {
+                api[aliasName] = api[canonicalName];
+            }
+        }
+    }
+    // Add special wrapper functions for text group (soundex/metaphone call fuzzyMatch with method param)
+    if (groupName === "text" && api["fuzzyMatch"] !== undefined) {
+        const fuzzyMatchFn = api["fuzzyMatch"];
+        // pg.text.soundex({table, column, value}) → fuzzyMatch({table, column, value, method: 'soundex'})
+        api["soundex"] = async (...args) => {
+            const normalizedParams = normalizeParams("soundex", args);
+            return fuzzyMatchFn({ ...normalizedParams, method: "soundex" });
+        };
+        // pg.text.metaphone({table, column, value}) → fuzzyMatch({table, column, value, method: 'metaphone'})
+        api["metaphone"] = async (...args) => {
+            const normalizedParams = normalizeParams("metaphone", args);
+            return fuzzyMatchFn({ ...normalizedParams, method: "metaphone" });
+        };
+    }
+    // Add special wrapper functions for performance group
+    if (groupName === "performance") {
+        const locksFn = api["locks"];
+        const statActivityFn = api["statActivity"];
+        // pg.performance.blockingQueries() → locks({ showBlocked: true })
+        if (locksFn !== undefined) {
+            api["blockingQueries"] = async () => {
+                return locksFn({ showBlocked: true });
+            };
+        }
+        // pg.performance.longRunningQueries(seconds?) → {longRunningQueries, count, threshold}
+        if (statActivityFn !== undefined) {
+            api["longRunningQueries"] = async (...args) => {
+                // Support both: longRunningQueries(10) and longRunningQueries({seconds: 10})
+                let minSeconds;
+                const arg0 = args[0];
+                if (typeof arg0 === "number") {
+                    minSeconds = arg0;
+                }
+                else if (typeof arg0 === "object" && arg0 !== null) {
+                    const obj = arg0;
+                    const secVal = obj["seconds"] ??
+                        obj["threshold"] ??
+                        obj["minSeconds"] ??
+                        obj["minDuration"];
+                    if (typeof secVal === "number") {
+                        minSeconds = secVal;
+                    }
+                }
+                const result = (await statActivityFn({ includeIdle: false }));
+                const threshold = minSeconds ?? 5; // Default 5 seconds
+                const longRunning = result.connections.filter((conn) => {
+                    const duration = conn["duration"];
+                    if (typeof duration === "string") {
+                        // Parse interval like "00:00:10.123"
+                        const parts = duration.split(":");
+                        if (parts.length >= 3) {
+                            const hours = parseInt(parts[0] ?? "0", 10);
+                            const mins = parseInt(parts[1] ?? "0", 10);
+                            const secs = parseFloat(parts[2] ?? "0");
+                            const totalSeconds = hours * 3600 + mins * 60 + secs;
+                            return totalSeconds >= threshold;
+                        }
+                    }
+                    return false;
+                });
+                return {
+                    longRunningQueries: longRunning,
+                    count: longRunning.length,
+                    threshold: `${String(threshold)} seconds`,
+                };
+            };
+            // Add alias: runningQueries → longRunningQueries
+            api["runningQueries"] = api["longRunningQueries"];
+        }
+        // pg.performance.analyzeTable() → Actually runs ANALYZE (cross-group bridge to admin)
+        api["analyzeTable"] = async (...args) => {
+            const arg0 = args[0];
+            let tableName = "";
+            let schemaName = "public";
+            if (typeof arg0 === "string") {
+                // Handle schema.table format
+                if (arg0.includes(".")) {
+                    const parts = arg0.split(".");
+                    schemaName = parts[0] ?? "public";
+                    tableName = parts[1] ?? "";
+                }
+                else {
+                    tableName = arg0;
+                }
+            }
+            else if (typeof arg0 === "object" && arg0 !== null) {
+                const obj = arg0;
+                const tableVal = obj["table"] ?? obj["name"];
+                if (typeof tableVal === "string") {
+                    // Handle schema.table format in object form too
+                    if (tableVal.includes(".")) {
+                        const parts = tableVal.split(".");
+                        schemaName = parts[0] ?? "public";
+                        tableName = parts[1] ?? "";
+                    }
+                    else {
+                        tableName = tableVal;
+                    }
+                }
+                // Only use explicit schema if table didn't contain schema prefix
+                const schemaVal = obj["schema"];
+                if (typeof schemaVal === "string" &&
+                    !tableVal?.toString().includes(".")) {
+                    schemaName = schemaVal;
+                }
+            }
+            if (tableName === "") {
+                return {
+                    error: "Table name required",
+                    usage: 'pg.performance.analyzeTable("table_name") or pg.performance.analyzeTable({ table: "name", schema: "public" })',
+                };
+            }
+            // Execute ANALYZE directly
+            const qualifiedName = `"${schemaName}"."${tableName}"`;
+            await adapter.executeQuery(`ANALYZE ${qualifiedName}`);
+            return {
+                success: true,
+                message: `ANALYZE completed on ${qualifiedName}`,
+                hint: "Table statistics updated for query planner optimization.",
+            };
+        };
+    }
+    return api;
+}
+/**
+ * Convert tool name to camelCase method name
+ * Examples:
+ *   pg_read_query (core) -> readQuery
+ *   pg_jsonb_extract (jsonb) -> extract
+ *   pg_vector_search (vector) -> search
+ */
+export function toolNameToMethodName(toolName, groupName) {
+    // Remove pg_ prefix
+    let name = toolName.replace(/^pg_/, "");
+    // Remove group prefix if present
+    const groupPrefix = groupName.replace(/-/g, "_") + "_";
+    if (name.startsWith(groupPrefix)) {
+        name = name.substring(groupPrefix.length);
+    }
+    // Convert snake_case to camelCase
+    return name.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+//# sourceMappingURL=group-api.js.map

package/dist/codemode/api/group-api.js.map

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

package/dist/codemode/{api.d.ts → api/index.d.ts}

@@ -1,10 +1,10 @@
 /**
  * postgres-mcp - Code Mode API
  *
- * Exposes all 194 PostgreSQL tools organized by their 19 groups
- * for use within the sandboxed execution environment.
+ * Main API class exposing all 21 tool groups organized for the
+ * sandboxed code execution environment.
  */
-import type { PostgresAdapter } from "../adapters/postgresql/PostgresAdapter.js";
+import type { PostgresAdapter } from "../../adapters/postgresql/PostgresAdapter.js";
 /**
  * Main API class exposing all tool groups
  */
@@ -60,4 +60,4 @@ export declare class PgApi {
  * Create a PgApi instance for an adapter
  */
 export declare function createPgApi(adapter: PostgresAdapter): PgApi;
-//# sourceMappingURL=api.d.ts.map
+//# sourceMappingURL=index.d.ts.map

package/dist/codemode/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/codemode/api/index.ts"],"names":[],"mappings":"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"}

package/dist/codemode/api/index.js

@@ -0,0 +1,192 @@
+/**
+ * postgres-mcp - Code Mode API
+ *
+ * Main API class exposing all 21 tool groups organized for the
+ * sandboxed code execution environment.
+ */
+import { METHOD_ALIASES, GROUP_EXAMPLES } from "./maps.js";
+import { TOP_LEVEL_ALIASES } from "./aliases.js";
+import { createGroupApi, toolNameToMethodName } from "./group-api.js";
+/**
+ * Main API class exposing all tool groups
+ */
+export class PgApi {
+    core;
+    transactions;
+    jsonb;
+    text;
+    performance;
+    admin;
+    monitoring;
+    backup;
+    schema;
+    vector;
+    postgis;
+    partitioning;
+    stats;
+    cron;
+    partman;
+    kcache;
+    citext;
+    ltree;
+    pgcrypto;
+    introspection;
+    toolsByGroup;
+    constructor(adapter) {
+        // Get all tool definitions and group them
+        const allTools = adapter.getToolDefinitions();
+        this.toolsByGroup = this.groupTools(allTools);
+        // Create group-specific APIs
+        this.core = createGroupApi(adapter, "core", this.toolsByGroup.get("core") ?? []);
+        this.transactions = createGroupApi(adapter, "transactions", this.toolsByGroup.get("transactions") ?? []);
+        this.jsonb = createGroupApi(adapter, "jsonb", this.toolsByGroup.get("jsonb") ?? []);
+        this.text = createGroupApi(adapter, "text", this.toolsByGroup.get("text") ?? []);
+        this.performance = createGroupApi(adapter, "performance", this.toolsByGroup.get("performance") ?? []);
+        this.admin = createGroupApi(adapter, "admin", this.toolsByGroup.get("admin") ?? []);
+        this.monitoring = createGroupApi(adapter, "monitoring", this.toolsByGroup.get("monitoring") ?? []);
+        this.backup = createGroupApi(adapter, "backup", this.toolsByGroup.get("backup") ?? []);
+        this.schema = createGroupApi(adapter, "schema", this.toolsByGroup.get("schema") ?? []);
+        this.vector = createGroupApi(adapter, "vector", this.toolsByGroup.get("vector") ?? []);
+        this.postgis = createGroupApi(adapter, "postgis", this.toolsByGroup.get("postgis") ?? []);
+        this.partitioning = createGroupApi(adapter, "partitioning", this.toolsByGroup.get("partitioning") ?? []);
+        this.stats = createGroupApi(adapter, "stats", this.toolsByGroup.get("stats") ?? []);
+        this.cron = createGroupApi(adapter, "cron", this.toolsByGroup.get("cron") ?? []);
+        this.partman = createGroupApi(adapter, "partman", this.toolsByGroup.get("partman") ?? []);
+        this.kcache = createGroupApi(adapter, "kcache", this.toolsByGroup.get("kcache") ?? []);
+        this.citext = createGroupApi(adapter, "citext", this.toolsByGroup.get("citext") ?? []);
+        this.ltree = createGroupApi(adapter, "ltree", this.toolsByGroup.get("ltree") ?? []);
+        this.pgcrypto = createGroupApi(adapter, "pgcrypto", this.toolsByGroup.get("pgcrypto") ?? []);
+        this.introspection = createGroupApi(adapter, "introspection", this.toolsByGroup.get("introspection") ?? []);
+    }
+    /**
+     * Group tools by their tool group
+     */
+    groupTools(tools) {
+        const grouped = new Map();
+        for (const tool of tools) {
+            const group = tool.group;
+            const existing = grouped.get(group);
+            if (existing) {
+                existing.push(tool);
+            }
+            else {
+                grouped.set(group, [tool]);
+            }
+        }
+        return grouped;
+    }
+    /**
+     * Get list of available groups and their method counts
+     */
+    getAvailableGroups() {
+        const groups = {};
+        for (const [group, tools] of this.toolsByGroup) {
+            groups[group] = tools.length;
+        }
+        return groups;
+    }
+    /**
+     * Get list of methods available in a group
+     */
+    getGroupMethods(groupName) {
+        const groupApi = this[groupName];
+        if (typeof groupApi === "object" && groupApi !== null) {
+            return Object.keys(groupApi);
+        }
+        return [];
+    }
+    /**
+     * Get help information listing all groups and their methods.
+     * Call pg.help() in code mode to discover available APIs.
+     *
+     * @returns Object with group names as keys and arrays of method names as values
+     */
+    help() {
+        const result = {};
+        for (const [group, tools] of this.toolsByGroup) {
+            // Skip codemode group itself
+            if (group === "codemode")
+                continue;
+            result[group] = tools.map((t) => toolNameToMethodName(t.name, group));
+        }
+        return result;
+    }
+    /**
+     * Create a serializable API binding for the sandbox
+     * This creates references that can be called from isolated-vm
+     */
+    createSandboxBindings() {
+        const bindings = {};
+        const groupNames = [
+            "core",
+            "transactions",
+            "jsonb",
+            "text",
+            "performance",
+            "admin",
+            "monitoring",
+            "backup",
+            "schema",
+            "vector",
+            "postgis",
+            "partitioning",
+            "stats",
+            "cron",
+            "partman",
+            "kcache",
+            "citext",
+            "ltree",
+            "pgcrypto",
+            "introspection",
+        ];
+        for (const groupName of groupNames) {
+            const groupApi = this[groupName];
+            // Capture all method names including aliases
+            const allMethodNames = Object.keys(groupApi);
+            // Separate canonical methods from aliases for structured help output
+            const aliases = METHOD_ALIASES[groupName] ?? {};
+            const aliasNames = new Set(Object.keys(aliases));
+            const canonicalMethodNames = allMethodNames.filter((name) => !aliasNames.has(name));
+            // Filter aliases to only show useful shorthand aliases in help output
+            // Exclude redundant prefix aliases (e.g., partmanShowConfig, cronListJobs) that
+            // just add the group name prefix - these are fallback catches, not intended API
+            const usefulAliases = allMethodNames.filter((name) => {
+                if (!aliasNames.has(name))
+                    return false;
+                // Exclude aliases that start with the group name (redundant prefixes)
+                const lowerGroupName = groupName.toLowerCase();
+                const lowerAlias = name.toLowerCase();
+                return !lowerAlias.startsWith(lowerGroupName);
+            });
+            // Add all methods plus a 'help' property that lists them
+            bindings[groupName] = {
+                ...groupApi,
+                // Help returns all methods - canonical first, then method aliases, plus examples
+                // Note: methodAliases are alternate names within THIS group (e.g., pg.partman.analyzeHealth → pg.partman.analyzePartitionHealth)
+                // They are NOT top-level pg.* aliases. Redundant prefix aliases (e.g., partmanShowConfig) are excluded.
+                help: () => ({
+                    methods: canonicalMethodNames,
+                    methodAliases: usefulAliases,
+                    examples: GROUP_EXAMPLES[groupName],
+                }),
+            };
+        }
+        // Add top-level help as directly callable pg.help()
+        bindings["help"] = () => this.help();
+        // Add all top-level aliases from the data-driven constant
+        for (const { group, bindingName, methodName } of TOP_LEVEL_ALIASES) {
+            const groupApi = bindings[group];
+            if (groupApi?.[methodName] !== undefined) {
+                bindings[bindingName] = groupApi[methodName];
+            }
+        }
+        return bindings;
+    }
+}
+/**
+ * Create a PgApi instance for an adapter
+ */
+export function createPgApi(adapter) {
+    return new PgApi(adapter);
+}
+//# sourceMappingURL=index.js.map

package/dist/codemode/api/index.js.map

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

package/dist/codemode/api/maps.d.ts

@@ -0,0 +1,47 @@
+/**
+ * postgres-mcp - Code Mode API Data Maps
+ *
+ * Pure data declarations for method aliases, usage examples,
+ * positional parameter mappings, and argument wrapping rules.
+ */
+/**
+ * Method aliases for code mode API.
+ * Maps alternate method names to their canonical method names.
+ * Format: { groupName: { aliasName: canonicalName } }
+ *
+ * These aliases handle common naming misguesses where agents
+ * might try the redundant prefix pattern (e.g., jsonbExtract vs extract).
+ */
+export declare const METHOD_ALIASES: Record<string, Record<string, string>>;
+/**
+ * Usage examples for each group's help() output.
+ * Provides quick-reference examples for common operations.
+ */
+export declare const GROUP_EXAMPLES: Record<string, string[]>;
+/**
+ * Mapping of method names to their parameter names for positional argument support.
+ * Single string = first positional arg maps to this key
+ * Array = multiple positional args map to these keys in order
+ *
+ * Enables:
+ * - `pg.core.readQuery("SELECT...")` → `{ sql: "SELECT..." }`
+ * - `pg.core.exists("users", "id = 1")` → `{ table: "users", where: "id = 1" }`
+ * - `pg.transactions.savepoint(txId, "sp1")` → `{ transactionId: txId, name: "sp1" }`
+ */
+export declare const POSITIONAL_PARAM_MAP: Record<string, string | string[]>;
+/**
+ * Methods where a single array arg should be wrapped in a specific key
+ */
+export declare const ARRAY_WRAP_MAP: Record<string, string>;
+/**
+ * Methods where a single object arg should be wrapped in a specific key
+ * (instead of passed through directly).
+ *
+ * For pg_jsonb_object, the skipKeys array lists keys that indicate the user
+ * has already provided the correct structure (e.g., { data: {...} }).
+ */
+export declare const OBJECT_WRAP_MAP: Record<string, {
+    wrapKey: string;
+    skipKeys: string[];
+}>;
+//# sourceMappingURL=maps.d.ts.map

package/dist/codemode/api/maps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maps.d.ts","sourceRoot":"","sources":["../../../src/codemode/api/maps.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwNjE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CA4InD,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAoHlE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMjD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAClC,MAAM,EACN;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAUxC,CAAC"}