@sonisoft/now-sdk-ext-mcp 1.0.0

package/dist/tools/lookup-app.js

@@ -0,0 +1,242 @@
+import { z } from "zod";
+import { TableAPIRequest } from "@sonisoft/now-sdk-ext-core";
+import { withConnectionRetry, isRetryableResponse, } from "../common/connection.js";
+/**
+ * Maps sys_class_name values from the sys_scope hierarchy to
+ * human-readable labels for the output.
+ */
+function classNameToLabel(sysClassName) {
+    switch (sysClassName) {
+        case "sys_app":
+            return "Custom App";
+        case "sys_store_app":
+            return "Store App";
+        default:
+            return "Application";
+    }
+}
+/**
+ * Registers the lookup_app tool on the MCP server.
+ *
+ * Searches ServiceNow for applications (scoped apps) and platform plugins
+ * by name, scope namespace, or plugin ID. Queries sys_scope (which covers
+ * both sys_app and sys_store_app via table inheritance) and sys_plugins
+ * in parallel.
+ */
+export function registerLookupAppTool(server) {
+    server.registerTool("lookup_app", {
+        title: "Lookup Application or Plugin",
+        description: "Search for ServiceNow applications (scoped apps) and platform plugins by name, " +
+            "scope namespace, or plugin ID. Returns sys_id, name, scope, version, active status, " +
+            "and type for each match.\n\n" +
+            "ServiceNow uses a hierarchical table structure for packages:\n" +
+            "- sys_scope: All scoped applications (base table)\n" +
+            "  - sys_app: Custom applications in development on this instance\n" +
+            "  - sys_store_app: Applications installed from the ServiceNow Store or company app repo\n" +
+            "- sys_plugins: Platform plugins\n\n" +
+            "Key use cases:\n" +
+            "- Find an application's sys_id to pass as the `scope` parameter to execute_script " +
+            "(to run scripts within that application's scope)\n" +
+            "- Check whether a specific app or plugin is installed/active on the instance\n" +
+            "- Look up version, scope namespace, and vendor info for any application or plugin",
+        inputSchema: {
+            instance: z
+                .string()
+                .optional()
+                .describe("The ServiceNow instance auth alias (e.g., " +
+                '"dev224436", "prod"). If not provided, falls back ' +
+                "to the SN_AUTH_ALIAS environment variable."),
+            search_term: z
+                .string()
+                .describe("Name, scope namespace (e.g., \"x_acme_my_app\", \"sn_vul\"), or plugin ID " +
+                "(e.g., \"com.snc.vulnerability_response\") to search for. " +
+                "Case-insensitive partial matching (contains)."),
+            type: z
+                .enum(["all", "app", "plugin"])
+                .default("all")
+                .describe('Filter search scope. "app" searches scoped applications only (sys_scope table ' +
+                "which includes both custom apps and store apps), " +
+                '"plugin" searches platform plugins only (sys_plugins table), ' +
+                '"all" searches both. Default is "all".'),
+            active_only: z
+                .boolean()
+                .default(false)
+                .describe("When true, only returns active/installed applications and plugins. " +
+                "Default is false (returns all matches regardless of active status)."),
+        },
+    }, async ({ instance, search_term, type, active_only }) => {
+        try {
+            const results = await withConnectionRetry(instance, async (snInstance) => {
+                const tableApi = new TableAPIRequest(snInstance);
+                // Build sys_scope query with ^NQ for OR grouping across
+                // name, scope namespace, and short_description.
+                const buildScopeQuery = () => {
+                    const prefix = active_only ? "active=true^" : "";
+                    const parts = [
+                        `${prefix}nameLIKE${search_term}`,
+                        `${prefix}scopeLIKE${search_term}`,
+                        `${prefix}short_descriptionLIKE${search_term}`,
+                    ];
+                    return parts.join("^NQ") + "^ORDERBYname";
+                };
+                // Build sys_plugins query with ^NQ for OR grouping across
+                // name and plugin id.
+                const buildPluginQuery = () => {
+                    const prefix = active_only ? "active=true^" : "";
+                    const parts = [
+                        `${prefix}nameLIKE${search_term}`,
+                        `${prefix}idLIKE${search_term}`,
+                    ];
+                    return parts.join("^NQ") + "^ORDERBYname";
+                };
+                // Execute queries in parallel, skipping based on type filter
+                const scopePromise = type === "plugin"
+                    ? Promise.resolve(null)
+                    : tableApi.get("sys_scope", {
+                        sysparm_query: buildScopeQuery(),
+                        sysparm_fields: "sys_id,name,scope,version,vendor,active,short_description,sys_class_name",
+                        sysparm_limit: 25,
+                        sysparm_display_value: "false",
+                    });
+                const pluginPromise = type === "app"
+                    ? Promise.resolve(null)
+                    : tableApi.get("sys_plugins", {
+                        sysparm_query: buildPluginQuery(),
+                        sysparm_fields: "sys_id,name,id,version,active",
+                        sysparm_limit: 25,
+                        sysparm_display_value: "false",
+                    });
+                const [scopeResp, pluginResp] = await Promise.all([
+                    scopePromise,
+                    pluginPromise,
+                ]);
+                // Check for retryable responses (stale session, no response)
+                if (scopeResp && isRetryableResponse(scopeResp)) {
+                    const status = scopeResp?.status ?? "unknown";
+                    throw new Error(`HTTP ${status} querying sys_scope`);
+                }
+                if (pluginResp && isRetryableResponse(pluginResp)) {
+                    const status = pluginResp?.status ?? "unknown";
+                    throw new Error(`HTTP ${status} querying sys_plugins`);
+                }
+                return { scopeResp, pluginResp };
+            });
+            const { scopeResp, pluginResp } = results;
+            // Check for non-retryable HTTP errors
+            if (scopeResp && scopeResp.status !== 200) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error querying applications: HTTP ${scopeResp.status} ${scopeResp.statusText}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            if (pluginResp && pluginResp.status !== 200) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error querying plugins: HTTP ${pluginResp.status} ${pluginResp.statusText}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const apps = scopeResp?.bodyObject?.result ?? [];
+            const plugins = pluginResp?.bodyObject?.result ?? [];
+            const totalFound = apps.length + plugins.length;
+            // Format output
+            const lines = [];
+            lines.push("=== Application & Plugin Search Results ===");
+            const searchInfo = [`Search: "${search_term}"`];
+            searchInfo.push(`Type: ${type}`);
+            if (active_only)
+                searchInfo.push("Active only: yes");
+            lines.push(searchInfo.join(" | "));
+            lines.push(`Found: ${totalFound} result(s)`);
+            // Applications section
+            if (type !== "plugin") {
+                lines.push("");
+                lines.push(`--- Applications (${apps.length}) ---`);
+                if (apps.length === 0) {
+                    lines.push("No matching applications found.");
+                }
+                else {
+                    apps.forEach((app, index) => {
+                        const appType = classNameToLabel(app.sys_class_name);
+                        lines.push("");
+                        lines.push(`${index + 1}. ${app.name}`);
+                        lines.push(`   sys_id: ${app.sys_id}`);
+                        lines.push(`   Scope: ${app.scope}`);
+                        lines.push(`   Version: ${app.version || "N/A"}`);
+                        lines.push(`   Type: ${appType}`);
+                        lines.push(`   Active: ${app.active}`);
+                        if (app.vendor)
+                            lines.push(`   Vendor: ${app.vendor}`);
+                        if (app.short_description) {
+                            const truncated = app.short_description.length > 120
+                                ? app.short_description.substring(0, 120) + "..."
+                                : app.short_description;
+                            lines.push(`   Description: ${truncated}`);
+                        }
+                    });
+                }
+            }
+            // Plugins section
+            if (type !== "app") {
+                lines.push("");
+                lines.push(`--- Plugins (${plugins.length}) ---`);
+                if (plugins.length === 0) {
+                    lines.push("No matching plugins found.");
+                }
+                else {
+                    plugins.forEach((plugin, index) => {
+                        lines.push("");
+                        lines.push(`${index + 1}. ${plugin.name}`);
+                        lines.push(`   sys_id: ${plugin.sys_id}`);
+                        lines.push(`   Plugin ID: ${plugin.id}`);
+                        lines.push(`   Version: ${plugin.version || "N/A"}`);
+                        lines.push(`   Active: ${plugin.active}`);
+                    });
+                }
+            }
+            // Footer
+            lines.push("");
+            lines.push(`=== ${totalFound} result(s) found ===`);
+            if (apps.length > 0) {
+                lines.push("");
+                lines.push("Tip: Use an application's sys_id as the `scope` parameter in execute_script " +
+                    "to run scripts within that application's scope.");
+            }
+            if (totalFound === 0) {
+                lines.push("");
+                lines.push("No applications or plugins matched your search. " +
+                    "Try a shorter or different search term.");
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: lines.join("\n"),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error looking up applications: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=lookup-app.js.map

package/dist/tools/lookup-app.js.map

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

package/dist/tools/lookup-columns.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers the lookup_columns tool on the MCP server.
+ *
+ * Searches sys_dictionary for columns on a specific table. Useful for
+ * validating column names and discovering available fields before
+ * building queries or scripts.
+ */
+export declare function registerLookupColumnsTool(server: McpServer): void;
+//# sourceMappingURL=lookup-columns.d.ts.map

package/dist/tools/lookup-columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup-columns.d.ts","sourceRoot":"","sources":["../../src/tools/lookup-columns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0CpE;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgMjE"}

package/dist/tools/lookup-columns.js

@@ -0,0 +1,180 @@
+import { z } from "zod";
+import { TableAPIRequest } from "@sonisoft/now-sdk-ext-core";
+import { withConnectionRetry, isRetryableResponse, } from "../common/connection.js";
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Coerce any Table API field value to a plain string.
+ *
+ * With `sysparm_display_value=true`, non-reference fields come back as
+ * strings, but reference fields arrive as `{ display_value, link }`.
+ * This helper normalises both shapes to a string.
+ */
+function str(field) {
+    if (field == null)
+        return "";
+    if (typeof field === "string")
+        return field;
+    if (typeof field === "object" && "display_value" in field) {
+        return String(field.display_value ?? "");
+    }
+    return String(field);
+}
+/**
+ * Registers the lookup_columns tool on the MCP server.
+ *
+ * Searches sys_dictionary for columns on a specific table. Useful for
+ * validating column names and discovering available fields before
+ * building queries or scripts.
+ */
+export function registerLookupColumnsTool(server) {
+    server.registerTool("lookup_columns", {
+        title: "Lookup Table Columns",
+        description: "List or search columns (fields) on a ServiceNow table. Queries the sys_dictionary " +
+            "table to find column names, types, and metadata for a given table.\n\n" +
+            "Use this tool to:\n" +
+            "- List all columns on a table to see what fields are available\n" +
+            "- Validate a column name before using it in a query or script\n" +
+            "- Find the correct internal element name when you only know the display label\n" +
+            "- Check column types, whether a field is mandatory, read-only, or a reference\n\n" +
+            "Returns: element name (internal), column label (display), type, " +
+            "max length, reference target, mandatory/read-only/active flags.",
+        inputSchema: {
+            instance: z
+                .string()
+                .optional()
+                .describe("The ServiceNow instance auth alias (e.g., " +
+                '"dev224436", "prod"). If not provided, falls back ' +
+                "to the SN_AUTH_ALIAS environment variable."),
+            table: z
+                .string()
+                .describe("The internal table name to look up columns for (e.g., " +
+                '"incident", "cmdb_ci_server", "sys_user"). ' +
+                "Use lookup_table first if you are unsure of the exact table name."),
+            search_term: z
+                .string()
+                .optional()
+                .describe("Optional filter to search columns by element name or label. " +
+                "Case-insensitive partial matching (contains). " +
+                'Examples: "assigned", "priority", "sys_created". ' +
+                "If omitted, returns all columns on the table."),
+            limit: z
+                .number()
+                .min(1)
+                .max(200)
+                .default(50)
+                .describe("Maximum number of columns to return. Default is 50, max is 200."),
+        },
+    }, async ({ instance, table, search_term, limit }) => {
+        try {
+            const response = await withConnectionRetry(instance, async (snInstance) => {
+                const tableApi = new TableAPIRequest(snInstance);
+                // Base filter: columns for this table, excluding the
+                // "collection" row which is the table definition itself.
+                const base = `name=${table}^internal_type!=collection`;
+                let query;
+                if (search_term) {
+                    // ^NQ OR grouping: search by element name or column label
+                    query =
+                        `${base}^elementLIKE${search_term}` +
+                            `^NQ${base}^column_labelLIKE${search_term}` +
+                            `^ORDERBYelement`;
+                }
+                else {
+                    query = `${base}^ORDERBYelement`;
+                }
+                const resp = await tableApi.get("sys_dictionary", {
+                    sysparm_query: query,
+                    sysparm_fields: "element,column_label,internal_type,max_length,reference,mandatory,active,read_only,default_value",
+                    sysparm_limit: limit,
+                    sysparm_display_value: "all",
+                });
+                if (isRetryableResponse(resp)) {
+                    const status = resp?.status ?? "unknown";
+                    throw new Error(`HTTP ${status} querying sys_dictionary`);
+                }
+                return resp;
+            });
+            if (response.status !== 200) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error querying columns: HTTP ${response.status} ${response.statusText}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const columns = response.bodyObject?.result ?? [];
+            const lines = [];
+            lines.push(`=== Columns for table: ${table} ===`);
+            if (search_term) {
+                lines.push(`Search: "${search_term}"`);
+            }
+            lines.push(`Found: ${columns.length} column(s)`);
+            if (columns.length === 0) {
+                lines.push("");
+                if (search_term) {
+                    lines.push(`No columns matching "${search_term}" found on table "${table}". ` +
+                        "Try a shorter search term or omit it to see all columns.");
+                }
+                else {
+                    lines.push(`No columns found for table "${table}". ` +
+                        "Verify the table name is correct using lookup_table.");
+                }
+            }
+            else {
+                columns.forEach((col, index) => {
+                    const element = str(col.element);
+                    const label = str(col.column_label);
+                    const type = str(col.internal_type);
+                    const ref = str(col.reference);
+                    const mandatory = str(col.mandatory);
+                    const readOnly = str(col.read_only);
+                    const active = str(col.active);
+                    lines.push("");
+                    lines.push(`${index + 1}. ${element}` + (label ? ` (${label})` : ""));
+                    // Type line — include reference target when applicable
+                    let typeLine = `   Type: ${type}`;
+                    if (ref) {
+                        typeLine += ` -> ${ref}`;
+                    }
+                    lines.push(typeLine);
+                    lines.push(`   Mandatory: ${mandatory || "false"} | ` +
+                        `Read-only: ${readOnly || "false"} | ` +
+                        `Active: ${active || "true"}`);
+                    if (col.max_length) {
+                        lines.push(`   Max length: ${str(col.max_length)}`);
+                    }
+                    if (col.default_value) {
+                        lines.push(`   Default: ${str(col.default_value)}`);
+                    }
+                });
+                lines.push("");
+                lines.push("Tip: Use column element names (left of parentheses) in encoded queries, " +
+                    "GlideRecord scripts, and the fields parameter of query_table.");
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: lines.join("\n"),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error looking up columns: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=lookup-columns.js.map

package/dist/tools/lookup-columns.js.map

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

package/dist/tools/lookup-table.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers the lookup_table tool on the MCP server.
+ *
+ * Searches sys_db_object (the ServiceNow table registry) by table name
+ * or label. Useful for validating table names before using them in
+ * query_table, execute_script, or other tools.
+ */
+export declare function registerLookupTableTool(server: McpServer): void;
+//# sourceMappingURL=lookup-table.d.ts.map

package/dist/tools/lookup-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup-table.d.ts","sourceRoot":"","sources":["../../src/tools/lookup-table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwCpE;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyJ/D"}

package/dist/tools/lookup-table.js

@@ -0,0 +1,150 @@
+import { z } from "zod";
+import { TableAPIRequest } from "@sonisoft/now-sdk-ext-core";
+import { withConnectionRetry, isRetryableResponse, } from "../common/connection.js";
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Coerce any Table API field value to a plain string.
+ *
+ * With `sysparm_display_value=true`, non-reference fields come back as
+ * strings, but reference fields arrive as `{ display_value, link }`.
+ * This helper normalises both shapes to a string.
+ */
+function str(field) {
+    if (field == null)
+        return "";
+    if (typeof field === "string")
+        return field;
+    if (typeof field === "object" && "display_value" in field) {
+        return String(field.display_value ?? "");
+    }
+    return String(field);
+}
+/**
+ * Registers the lookup_table tool on the MCP server.
+ *
+ * Searches sys_db_object (the ServiceNow table registry) by table name
+ * or label. Useful for validating table names before using them in
+ * query_table, execute_script, or other tools.
+ */
+export function registerLookupTableTool(server) {
+    server.registerTool("lookup_table", {
+        title: "Lookup Table",
+        description: "Search for ServiceNow tables by name or label. Queries the sys_db_object table " +
+            "to find and validate table names.\n\n" +
+            "Use this tool to:\n" +
+            "- Verify a table name exists before using it with query_table or in GlideRecord scripts\n" +
+            "- Discover the correct internal name for a table when you only know the display label\n" +
+            "- Find related tables (e.g., search \"incident\" to see incident, incident_alert, etc.)\n" +
+            "- Check table hierarchy (which table a table extends)\n\n" +
+            "Returns: table name (internal), label (display), parent table, " +
+            "whether it is extendable, number prefix, and application scope.",
+        inputSchema: {
+            instance: z
+                .string()
+                .optional()
+                .describe("The ServiceNow instance auth alias (e.g., " +
+                '"dev224436", "prod"). If not provided, falls back ' +
+                "to the SN_AUTH_ALIAS environment variable."),
+            search_term: z
+                .string()
+                .describe("Table name or label to search for. Case-insensitive partial matching (contains). " +
+                'Examples: "incident", "cmdb_ci", "Change Request".'),
+            limit: z
+                .number()
+                .min(1)
+                .max(100)
+                .default(25)
+                .describe("Maximum number of results to return. Default is 25, max is 100."),
+        },
+    }, async ({ instance, search_term, limit }) => {
+        try {
+            const response = await withConnectionRetry(instance, async (snInstance) => {
+                const tableApi = new TableAPIRequest(snInstance);
+                // ^NQ OR grouping: search by internal name or display label
+                const query = `nameLIKE${search_term}` +
+                    `^NQlabelLIKE${search_term}` +
+                    `^ORDERBYname`;
+                const resp = await tableApi.get("sys_db_object", {
+                    sysparm_query: query,
+                    sysparm_fields: "sys_id,name,label,super_class,is_extendable,number_ref,sys_scope",
+                    sysparm_limit: limit,
+                    sysparm_display_value: "all",
+                });
+                if (isRetryableResponse(resp)) {
+                    const status = resp?.status ?? "unknown";
+                    throw new Error(`HTTP ${status} querying sys_db_object`);
+                }
+                return resp;
+            });
+            if (response.status !== 200) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error querying tables: HTTP ${response.status} ${response.statusText}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const tables = response.bodyObject?.result ?? [];
+            const lines = [];
+            lines.push("=== Table Search Results ===");
+            lines.push(`Search: "${search_term}"`);
+            lines.push(`Found: ${tables.length} table(s)`);
+            if (tables.length === 0) {
+                lines.push("");
+                lines.push("No tables found matching your search. " +
+                    "Try a shorter or different search term.");
+            }
+            else {
+                tables.forEach((table, index) => {
+                    const name = str(table.name);
+                    const label = str(table.label);
+                    const sysId = str(table.sys_id);
+                    const parent = str(table.super_class);
+                    const extendable = str(table.is_extendable);
+                    const numberRef = str(table.number_ref);
+                    const scope = str(table.sys_scope);
+                    lines.push("");
+                    lines.push(`${index + 1}. ${name}` + (label ? ` (${label})` : ""));
+                    lines.push(`   sys_id: ${sysId}`);
+                    if (parent) {
+                        lines.push(`   Extends: ${parent}`);
+                    }
+                    lines.push(`   Extendable: ${extendable || "false"}`);
+                    if (numberRef) {
+                        lines.push(`   Number prefix: ${numberRef}`);
+                    }
+                    if (scope) {
+                        lines.push(`   Scope: ${scope}`);
+                    }
+                });
+                lines.push("");
+                lines.push("Tip: Use the table name (not label) with query_table or in GlideRecord scripts. " +
+                    "Use lookup_columns to see the columns available on a table.");
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: lines.join("\n"),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error looking up tables: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=lookup-table.js.map

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

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

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

@@ -0,0 +1,16 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers the query_update_records tool on the MCP server.
+ *
+ * Finds records matching an encoded query and updates them in bulk.
+ * Supports dry-run mode (confirm=false) to preview affected records before committing.
+ */
+export declare function registerQueryUpdateRecordsTool(server: McpServer): void;
+/**
+ * Registers the query_delete_records tool on the MCP server.
+ *
+ * Finds records matching an encoded query and deletes them in bulk.
+ * Supports dry-run mode (confirm=false) to preview affected records before committing.
+ */
+export declare function registerQueryDeleteRecordsTool(server: McpServer): void;
+//# sourceMappingURL=query-batch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-batch.d.ts","sourceRoot":"","sources":["../../src/tools/query-batch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmHtE;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8GtE"}