@tedorigawa001/servicenow-mcp 1.0.2

package/dist/tools/updateset.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Update Set management tools — full lifecycle for ServiceNow Update Sets.
+ *
+ * Goes beyond the basic changeset tools in script.ts to provide:
+ * - Create / switch / preview / complete / export
+ * - Auto-creation guard (ensure active update set exists)
+ * - Batch artifact registration
+ *
+ * Tier 0 (Read):  get_current_update_set, list_update_sets, preview_update_set
+ * Tier 3 (Script): create_update_set, switch_update_set, complete_update_set,
+ *                   export_update_set, retrieve_remote_update_set
+ *
+ * ServiceNow tables: sys_update_set, sys_update_xml, sys_remote_update_set
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getUpdateSetToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            state?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            name?: undefined;
+            description?: undefined;
+            release?: undefined;
+            switch_to?: undefined;
+            sys_id?: undefined;
+            default_name?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            state: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            name?: undefined;
+            description?: undefined;
+            release?: undefined;
+            switch_to?: undefined;
+            sys_id?: undefined;
+            default_name?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            release: {
+                type: string;
+                description: string;
+            };
+            switch_to: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            sys_id?: undefined;
+            default_name?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            sys_id: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            name?: undefined;
+            description?: undefined;
+            release?: undefined;
+            switch_to?: undefined;
+            default_name?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            sys_id: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            query?: undefined;
+            name?: undefined;
+            description?: undefined;
+            release?: undefined;
+            switch_to?: undefined;
+            default_name?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            default_name: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            name?: undefined;
+            description?: undefined;
+            release?: undefined;
+            switch_to?: undefined;
+            sys_id?: undefined;
+        };
+        required: never[];
+    };
+})[];
+export declare function executeUpdateSetToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=updateset.d.ts.map

package/dist/tools/updateset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateset.d.ts","sourceRoot":"","sources":["../../src/tools/updateset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,wBAAgB,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA2F1C;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CA+Kd"}

package/dist/tools/updateset.js

@@ -0,0 +1,266 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireScripting } from '../utils/permissions.js';
+export function getUpdateSetToolDefinitions() {
+    return [
+        {
+            name: 'get_current_update_set',
+            description: 'Get the currently active Update Set for the session',
+            inputSchema: { type: 'object', properties: {}, required: [] },
+        },
+        {
+            name: 'list_update_sets',
+            description: 'List Update Sets by state (in progress, complete, ignore)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    state: { type: 'string', description: 'State filter: "in progress", "complete", "ignore"' },
+                    query: { type: 'string', description: 'Additional encoded query filter' },
+                    limit: { type: 'number', description: 'Max records (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'create_update_set',
+            description: 'Create a new Update Set and optionally switch to it. **[Scripting]**',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Update Set name' },
+                    description: { type: 'string', description: 'Purpose or description' },
+                    release: { type: 'string', description: 'Target release label' },
+                    switch_to: { type: 'boolean', description: 'Switch to this Update Set after creation (default true)' },
+                },
+                required: ['name'],
+            },
+        },
+        {
+            name: 'switch_update_set',
+            description: 'Switch the active Update Set context to a specified Update Set. **[Scripting]**',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'sys_id of the target Update Set' },
+                },
+                required: ['sys_id'],
+            },
+        },
+        {
+            name: 'complete_update_set',
+            description: 'Mark an Update Set as complete (ready for migration). **[Scripting]**',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'Update Set sys_id' },
+                },
+                required: ['sys_id'],
+            },
+        },
+        {
+            name: 'preview_update_set',
+            description: 'Preview all changes contained in an Update Set',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'Update Set sys_id' },
+                    limit: { type: 'number', description: 'Max records to list (default 100)' },
+                },
+                required: ['sys_id'],
+            },
+        },
+        {
+            name: 'export_update_set',
+            description: 'Get the XML export payload for an Update Set (as used in migration). **[Scripting]**',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'Update Set sys_id' },
+                },
+                required: ['sys_id'],
+            },
+        },
+        {
+            name: 'ensure_active_update_set',
+            description: 'Ensure an active Update Set exists; create one automatically if none is in progress. **[Scripting]**',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    default_name: { type: 'string', description: 'Name to use when auto-creating (default: "AI Session Update Set")' },
+                },
+                required: [],
+            },
+        },
+    ];
+}
+export async function executeUpdateSetToolCall(client, name, args) {
+    switch (name) {
+        case 'get_current_update_set': {
+            const resp = await client.queryRecords({
+                table: 'sys_update_set',
+                query: 'state=in progress',
+                limit: 5,
+                fields: 'sys_id,name,description,state,is_default,release,sys_updated_on,sys_updated_by',
+            });
+            return { count: resp.count, active_update_sets: resp.records };
+        }
+        case 'list_update_sets': {
+            let query = '';
+            if (args.state)
+                query = `state=${args.state}`;
+            if (args.query)
+                query = query ? `${query}^${args.query}` : args.query;
+            const resp = await client.queryRecords({
+                table: 'sys_update_set',
+                query: query || undefined,
+                limit: args.limit || 25,
+                fields: 'sys_id,name,state,description,release,sys_updated_on,sys_updated_by',
+            });
+            return { count: resp.count, update_sets: resp.records };
+        }
+        case 'create_update_set': {
+            if (!args.name)
+                throw new ServiceNowError('name is required', 'INVALID_REQUEST');
+            requireScripting();
+            const payload = { name: args.name, state: 'in progress' };
+            if (args.description)
+                payload.description = args.description;
+            if (args.release)
+                payload.release = args.release;
+            const result = await client.createRecord('sys_update_set', payload);
+            const newId = String(result.sys_id || result.result?.sys_id || '');
+            if (newId && args.switch_to !== false) {
+                await client.updateRecord('sys_update_set', newId, { is_default: true });
+                return { action: 'created_and_switched', name: args.name, sys_id: newId, ...result };
+            }
+            return { action: 'created', name: args.name, sys_id: newId, ...result };
+        }
+        case 'switch_update_set': {
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            requireScripting();
+            const result = await client.updateRecord('sys_update_set', args.sys_id, { is_default: true });
+            return { action: 'switched', sys_id: args.sys_id, ...result };
+        }
+        case 'complete_update_set': {
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            requireScripting();
+            const result = await client.updateRecord('sys_update_set', args.sys_id, { state: 'complete' });
+            return { action: 'completed', sys_id: args.sys_id, ...result };
+        }
+        case 'preview_update_set': {
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            // List all update XML records for this update set
+            const resp = await client.queryRecords({
+                table: 'sys_update_xml',
+                query: `update_set=${args.sys_id}`,
+                limit: args.limit || 100,
+                fields: 'sys_id,name,type,action,payload,sys_updated_on',
+            });
+            const updateSet = await client.getRecord('sys_update_set', args.sys_id);
+            return {
+                update_set: updateSet,
+                change_count: resp.count,
+                changes: resp.records.map((r) => ({
+                    sys_id: r.sys_id,
+                    name: r.name,
+                    type: r.type,
+                    action: r.action,
+                    updated: r.sys_updated_on,
+                })),
+            };
+        }
+        case 'export_update_set': {
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            requireScripting();
+            const updateSet = await client.getRecord('sys_update_set', args.sys_id);
+            // Paginate sys_update_xml to guarantee completeness; hard-cap at 2000 to avoid runaway responses
+            const PAGE_SIZE = 500;
+            const MAX_RECORDS = 2000;
+            const allXmlRecords = [];
+            let offset = 0;
+            while (true) {
+                const batch = await client.queryRecords({
+                    table: 'sys_update_xml',
+                    query: `update_set=${args.sys_id}`,
+                    limit: PAGE_SIZE,
+                    offset,
+                    fields: 'sys_id,name,type,action,payload',
+                });
+                allXmlRecords.push(...batch.records);
+                if (batch.records.length < PAGE_SIZE)
+                    break; // last page
+                offset += PAGE_SIZE;
+                if (allXmlRecords.length >= MAX_RECORDS) {
+                    throw new ServiceNowError(`Update Set contains more than ${MAX_RECORDS} changes and cannot be exported via MCP. ` +
+                        `Use ServiceNow UI (/sys_update_set_export.do?sysparm_sys_id=${args.sys_id}) to download the complete XML.`, 'RESULT_TOO_LARGE');
+                }
+            }
+            // Helper: extract string value from Table API field (handles reference objects)
+            function fieldVal(v) {
+                if (v === null || v === undefined)
+                    return '';
+                if (typeof v === 'object' && v.value !== undefined)
+                    return String(v.value ?? '');
+                return String(v);
+            }
+            // Helper: XML-escape a plain text value
+            function esc(v) {
+                return fieldVal(v).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+            }
+            const unloadDate = new Date().toISOString().replace('T', ' ').substring(0, 19);
+            const usName = fieldVal(updateSet.name);
+            // Build <sys_update_set> header element from update set record fields
+            const headerFields = [
+                'sys_id', 'name', 'description', 'state', 'release', 'is_default',
+                'sys_created_by', 'sys_created_on', 'sys_updated_by', 'sys_updated_on',
+                'application', 'application_version', 'base_update_set',
+            ];
+            const headerXml = headerFields
+                .map(k => `  <${k}>${esc(updateSet[k])}</${k}>`)
+                .join('\n');
+            // Collect payloads — each payload is a complete XML element ready for inclusion
+            const payloads = [];
+            for (const r of allXmlRecords) {
+                const p = fieldVal(r.payload);
+                if (p)
+                    payloads.push(p);
+            }
+            const xml = [
+                '<?xml version="1.0" encoding="UTF-8"?>',
+                `<unload unload_date="${unloadDate}">`,
+                '<sys_update_set action="INSERT_OR_UPDATE">',
+                headerXml,
+                '</sys_update_set>',
+                ...payloads,
+                '</unload>',
+            ].join('\n');
+            return {
+                update_set_name: usName,
+                sys_id: args.sys_id,
+                change_count: allXmlRecords.length,
+                xml,
+            };
+        }
+        case 'ensure_active_update_set': {
+            requireScripting();
+            const resp = await client.queryRecords({
+                table: 'sys_update_set',
+                query: 'state=in progress',
+                limit: 1,
+                fields: 'sys_id,name',
+            });
+            if (resp.count > 0) {
+                return { action: 'existing_found', update_set: resp.records[0] };
+            }
+            const defaultName = args.default_name || `AI Session Update Set ${new Date().toISOString().slice(0, 10)}`;
+            const created = await client.createRecord('sys_update_set', { name: defaultName, state: 'in progress', is_default: true });
+            return { action: 'auto_created', name: defaultName, update_set: created };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=updateset.js.map

package/dist/tools/updateset.js.map

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

package/dist/tools/usem-approval.d.ts

@@ -0,0 +1,130 @@
+/**
+ * USEM / Vulnerability Response approval actions — the workflow-sanctioned way
+ * to advance the state of VR records.
+ *
+ * Why this exists: VR record state (sn_vul_vulnerability groups, vulnerable
+ * items, exception requests) is driven by the platform workflow engine, not by
+ * direct field writes. Verified on a live PDI (dev400464):
+ *   - PATCH of `state` on sn_vul_vulnerability → INSUFFICIENT_PRIVILEGES (ACL)
+ *   - PATCH of VI `ignore_reason`/`ignore_date` → accepted but reverted by a
+ *     business rule (no effect)
+ * The reliable Table-API surface that DOES move workflow state is the approval
+ * record (sysapproval_approver): approving/rejecting it advances the attached
+ * workflow (e.g. an exception / risk-acceptance / false-positive request),
+ * which in turn transitions the underlying VR record.
+ *
+ * Linkage (verified live): VR exception approvals do NOT populate `sysapproval`.
+ * They are linked via `source_table` (e.g. sn_sec_exception_change_approval) and
+ * `document_id` (the Change Approval record), with `approval_source` naming the
+ * ultimate VR record class (e.g. sn_vul_vulnerability). Filtering is therefore
+ * done on `source_table`.
+ *
+ * Read tools: Tier 0. Write tools: Tier 1 (WRITE_ENABLED=true).
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getUsemApprovalToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            state: {
+                type: string;
+                description: string;
+            };
+            source_table: {
+                type: string;
+                description: string;
+            };
+            approval_source: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            request_type?: undefined;
+            approval_state?: undefined;
+            table?: undefined;
+            latest_only?: undefined;
+            query?: undefined;
+            sys_id?: undefined;
+            action?: undefined;
+            comments?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            request_type: {
+                type: string;
+                description: string;
+            };
+            approval_state: {
+                type: string;
+                description: string;
+            };
+            table: {
+                type: string;
+                description: string;
+            };
+            latest_only: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            source_table?: undefined;
+            approval_source?: undefined;
+            sys_id?: undefined;
+            action?: undefined;
+            comments?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            sys_id: {
+                type: string;
+                description: string;
+            };
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            comments: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            source_table?: undefined;
+            approval_source?: undefined;
+            limit?: undefined;
+            request_type?: undefined;
+            approval_state?: undefined;
+            table?: undefined;
+            latest_only?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare function executeUsemApprovalToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=usem-approval.d.ts.map

package/dist/tools/usem-approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usem-approval.d.ts","sourceRoot":"","sources":["../../src/tools/usem-approval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAsChE,wBAAgB,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAqE7C;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAsGd"}