@tedorigawa001/servicenow-mcp 1.0.2

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

@@ -0,0 +1,228 @@
+/**
+ * USEM / Vulnerability Response integration operations — manage the security
+ * data feeds (NVD, Qualys, Tenable, Red Hat, etc.): their catalog, the enabled
+ * implementations, run history, run detail, and troubleshooting logs.
+ *
+ * Complements `get_integration_health` (a rollup summary) with detailed listing,
+ * per-run drill-down, log diagnostics, and an enable/disable toggle.
+ *
+ * Read tools: Tier 0. Write tools: Tier 1 (WRITE_ENABLED=true).
+ *
+ * Tables / fields verified against a live PDI (dev400464):
+ *   sn_sec_int_integration  — integration catalog (name, id, source, type)
+ *   sn_sec_int_impl         — implementations/instances (active, is_default, ...)
+ *   sn_vul_integration_run  — run history (number VINTRUNxxxx, perf metrics,
+ *                             fatal_error_message; source e.g. "NVD")
+ *   sn_vul_integration_log  — logs linked to a run (type, message_value)
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getUsemIntegrationToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            active?: undefined;
+            display_value?: undefined;
+            source?: undefined;
+            state?: undefined;
+            substate?: undefined;
+            days?: undefined;
+            number_or_sysid?: undefined;
+            integration_run?: undefined;
+            type?: undefined;
+            category?: undefined;
+            sys_id?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            active: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            display_value: {
+                description: string;
+                oneOf: ({
+                    type: string;
+                    enum?: undefined;
+                } | {
+                    type: string;
+                    enum: string[];
+                })[];
+            };
+            source?: undefined;
+            state?: undefined;
+            substate?: undefined;
+            days?: undefined;
+            number_or_sysid?: undefined;
+            integration_run?: undefined;
+            type?: undefined;
+            category?: undefined;
+            sys_id?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            source: {
+                type: string;
+                description: string;
+            };
+            state: {
+                type: string;
+                description: string;
+            };
+            substate: {
+                type: string;
+                description: string;
+            };
+            days: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            display_value: {
+                description: string;
+                oneOf: ({
+                    type: string;
+                    enum?: undefined;
+                } | {
+                    type: string;
+                    enum: string[];
+                })[];
+            };
+            active?: undefined;
+            number_or_sysid?: undefined;
+            integration_run?: undefined;
+            type?: undefined;
+            category?: undefined;
+            sys_id?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            number_or_sysid: {
+                type: string;
+                description: string;
+            };
+            query?: undefined;
+            limit?: undefined;
+            active?: undefined;
+            display_value?: undefined;
+            source?: undefined;
+            state?: undefined;
+            substate?: undefined;
+            days?: undefined;
+            integration_run?: undefined;
+            type?: undefined;
+            category?: undefined;
+            sys_id?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            integration_run: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                description: string;
+            };
+            category: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            active?: undefined;
+            display_value?: undefined;
+            source?: undefined;
+            state?: undefined;
+            substate?: undefined;
+            days?: undefined;
+            number_or_sysid?: undefined;
+            sys_id?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            sys_id: {
+                type: string;
+                description: string;
+            };
+            active: {
+                type: string;
+                description: string;
+            };
+            query?: undefined;
+            limit?: undefined;
+            display_value?: undefined;
+            source?: undefined;
+            state?: undefined;
+            substate?: undefined;
+            days?: undefined;
+            number_or_sysid?: undefined;
+            integration_run?: undefined;
+            type?: undefined;
+            category?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare function executeUsemIntegrationToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=usem-integration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usem-integration.d.ts","sourceRoot":"","sources":["../../src/tools/usem-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAwBhE,wBAAgB,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAoGhD;AAED,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAuGd"}

package/dist/tools/usem-integration.js

@@ -0,0 +1,223 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireWrite } from '../utils/permissions.js';
+const SYS_ID_RE = /^[0-9a-f]{32}$/i;
+/** Strip encoded-query operators so a value can't break out of its clause. */
+function sanitize(v) {
+    return typeof v === 'string' ? v.replace(/[^a-zA-Z0-9 _.-]/g, '').trim() : '';
+}
+function clampDays(raw) {
+    if (raw === undefined || raw === null || raw === '')
+        return undefined;
+    const n = Number(raw);
+    return Number.isFinite(n) ? Math.min(Math.max(Math.trunc(n), 1), 365) : undefined;
+}
+const RUN_FIELDS = 'number,source,state,substate,start_datetime,end_datetime,vi_created,vi_updated,' +
+    'vi_new_findings,det_created,fatal_error_message,notes,implementation,integration,sys_id';
+const LOG_FIELDS = 'type,category,message_value,suggested_recommendations,integration_run,sys_created_on,sys_id';
+export function getUsemIntegrationToolDefinitions() {
+    return [
+        {
+            name: 'list_integrations',
+            description: 'List the USEM/VR integration catalog (sn_sec_int_integration) — the available security ' +
+                'data feeds such as NVD, Qualys, Tenable, Red Hat. Returns name, id, source and type.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Additional raw encoded query appended with ^' },
+                    limit: { type: 'number', description: 'Max records (default: 50, max: 1000)' },
+                },
+            },
+        },
+        {
+            name: 'list_integration_implementations',
+            description: 'List configured integration implementations/instances (sn_sec_int_impl) — the operational ' +
+                'units that carry the active flag, default flag and validation status. Use this to see which ' +
+                'feeds are actually enabled.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    active: { type: 'boolean', description: 'Filter by active state' },
+                    query: { type: 'string', description: 'Additional raw encoded query appended with ^' },
+                    limit: { type: 'number', description: 'Max records (default: 50, max: 1000)' },
+                    display_value: {
+                        description: 'Return human-readable reference/choice values (true) or both raw and display ("all")',
+                        oneOf: [{ type: 'boolean' }, { type: 'string', enum: ['all'] }],
+                    },
+                },
+            },
+        },
+        {
+            name: 'list_integration_runs',
+            description: 'List Vulnerability Integration Runs (sn_vul_integration_run) with detail. Filter by source ' +
+                '(e.g. "NVD"), state, substate ("success"/"failed"), or a recent day window. Ordered newest ' +
+                'first. For a quick health rollup use get_integration_health instead.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    source: { type: 'string', description: 'Integration source filter, e.g. "NVD", "Qualys"' },
+                    state: { type: 'string', description: 'Run state filter, e.g. "complete"' },
+                    substate: { type: 'string', description: 'Run substate filter, e.g. "success" or "failed"' },
+                    days: { type: 'number', description: 'Only runs started within the last N days (1-365)' },
+                    query: { type: 'string', description: 'Additional raw encoded query appended with ^' },
+                    limit: { type: 'number', description: 'Max records (default: 25, max: 1000)' },
+                    display_value: {
+                        description: 'Return human-readable reference/choice values (true) or both raw and display ("all")',
+                        oneOf: [{ type: 'boolean' }, { type: 'string', enum: ['all'] }],
+                    },
+                },
+            },
+        },
+        {
+            name: 'get_integration_run',
+            description: 'Get full detail of a single Vulnerability Integration Run by run number (VINTRUNxxxx) or ' +
+                'sys_id, including performance metrics and any fatal_error_message.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    number_or_sysid: { type: 'string', description: 'Run number (VINTRUNxxxx) or 32-char sys_id' },
+                },
+                required: ['number_or_sysid'],
+            },
+        },
+        {
+            name: 'list_integration_logs',
+            description: 'List integration log entries (sn_vul_integration_log) for troubleshooting — error and ' +
+                'recommendation messages, optionally scoped to a single run. Ordered newest first.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    integration_run: { type: 'string', description: 'Filter to a single run (sys_id of sn_vul_integration_run)' },
+                    type: { type: 'string', description: 'Log type filter, e.g. "error", "warning", "info"' },
+                    category: { type: 'string', description: 'Log category filter' },
+                    query: { type: 'string', description: 'Additional raw encoded query appended with ^' },
+                    limit: { type: 'number', description: 'Max records (default: 50, max: 1000)' },
+                },
+            },
+        },
+        {
+            name: 'set_integration_active',
+            description: 'Enable or disable an integration implementation (sn_sec_int_impl) by sys_id. This turns a ' +
+                'security data feed on or off. **[Write — requires WRITE_ENABLED=true; admin-level change]**',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: '32-char sys_id of the sn_sec_int_impl implementation' },
+                    active: { type: 'boolean', description: 'true to enable, false to disable' },
+                },
+                required: ['sys_id', 'active'],
+            },
+        },
+    ];
+}
+export async function executeUsemIntegrationToolCall(client, name, args) {
+    switch (name) {
+        case 'list_integrations': {
+            const resp = await client.queryRecords({
+                table: 'sn_sec_int_integration',
+                query: args.query ?? '',
+                fields: 'name,id,source,integration_type,short_description,configurable,order,sys_id',
+                orderBy: 'order',
+                limit: args.limit ?? 50,
+            });
+            return { count: resp.count, records: resp.records, summary: `Found ${resp.count} integration(s)` };
+        }
+        case 'list_integration_implementations': {
+            const parts = [];
+            if (args.active !== undefined)
+                parts.push(`active=${args.active === true}`);
+            if (args.query)
+                parts.push(args.query);
+            const resp = await client.queryRecords({
+                table: 'sn_sec_int_impl',
+                query: parts.join('^'),
+                fields: 'name,active,integration,is_default,validation_status,sys_id',
+                orderBy: 'name',
+                limit: args.limit ?? 50,
+                display_value: args.display_value,
+            });
+            return { count: resp.count, records: resp.records, summary: `Found ${resp.count} implementation(s)` };
+        }
+        case 'list_integration_runs': {
+            const parts = [];
+            const days = clampDays(args.days);
+            if (days !== undefined)
+                parts.push(`start_datetime>=javascript:gs.daysAgo(${days})`);
+            const source = sanitize(args.source);
+            if (args.source && source)
+                parts.push(`source=${source}`);
+            const state = sanitize(args.state);
+            if (args.state && state)
+                parts.push(`state=${state}`);
+            const substate = sanitize(args.substate);
+            if (args.substate && substate)
+                parts.push(`substate=${substate}`);
+            if (args.query)
+                parts.push(args.query);
+            const resp = await client.queryRecords({
+                table: 'sn_vul_integration_run',
+                query: parts.join('^'),
+                fields: RUN_FIELDS,
+                orderBy: '-start_datetime',
+                limit: args.limit ?? 25,
+                display_value: args.display_value,
+            });
+            return { count: resp.count, records: resp.records, summary: `Found ${resp.count} integration run(s)` };
+        }
+        case 'get_integration_run': {
+            if (!args.number_or_sysid)
+                throw new ServiceNowError('number_or_sysid is required', 'INVALID_REQUEST');
+            if (SYS_ID_RE.test(args.number_or_sysid)) {
+                return await client.getRecord('sn_vul_integration_run', args.number_or_sysid);
+            }
+            const resp = await client.queryRecords({
+                table: 'sn_vul_integration_run',
+                query: `number=${sanitize(args.number_or_sysid)}`,
+                limit: 1,
+            });
+            if (resp.count === 0)
+                throw new ServiceNowError(`Integration run not found: ${args.number_or_sysid}`, 'NOT_FOUND');
+            return resp.records[0];
+        }
+        case 'list_integration_logs': {
+            const parts = [];
+            if (args.integration_run) {
+                if (!SYS_ID_RE.test(args.integration_run)) {
+                    throw new ServiceNowError('integration_run must be a 32-character sys_id', 'INVALID_REQUEST');
+                }
+                parts.push(`integration_run=${args.integration_run}`);
+            }
+            const type = sanitize(args.type);
+            if (args.type && type)
+                parts.push(`type=${type}`);
+            const category = sanitize(args.category);
+            if (args.category && category)
+                parts.push(`category=${category}`);
+            if (args.query)
+                parts.push(args.query);
+            const resp = await client.queryRecords({
+                table: 'sn_vul_integration_log',
+                query: parts.join('^'),
+                fields: LOG_FIELDS,
+                orderBy: '-sys_created_on',
+                limit: args.limit ?? 50,
+            });
+            return { count: resp.count, records: resp.records, summary: `Found ${resp.count} integration log entry/entries` };
+        }
+        case 'set_integration_active': {
+            requireWrite();
+            if (!args.sys_id || !SYS_ID_RE.test(args.sys_id)) {
+                throw new ServiceNowError('sys_id must be a 32-character hex string', 'INVALID_REQUEST');
+            }
+            if (typeof args.active !== 'boolean')
+                throw new ServiceNowError('active (boolean) is required', 'INVALID_REQUEST');
+            const result = await client.updateRecord('sn_sec_int_impl', args.sys_id, { active: args.active });
+            return {
+                ...result,
+                summary: `${args.active ? 'Enabled' : 'Disabled'} integration implementation ${args.sys_id}`,
+            };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=usem-integration.js.map

package/dist/tools/usem-integration.js.map

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

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

@@ -0,0 +1,201 @@
+/**
+ * USEM / Vulnerability Response SLA (TTR) + notification operations for
+ * Vulnerable Items (VI) and Remediation Tasks (RT).
+ *
+ * VI/RT do NOT extend the platform `task` table, so the generic task_sla tools
+ * (get_sla_details/list_active_slas) do not apply. Their SLA is the built-in
+ * Time-To-Remediate (TTR) mechanism stored on the records themselves:
+ *   ttr_status        — no_target | in_flight | approaching | past_due | target_met
+ *   ttr_target_date   — the remediation deadline
+ *   ttr_applied_rule  — which sn_sec_wf_ttr_rule produced the target
+ * VI additionally carries remediation_commitment_dt_tm (a manual commitment).
+ *
+ * VR notification *definitions* live in the standard sysevent_email_action
+ * table, so create/update use the existing notification tools; this module adds
+ * a VR-scoped discovery convenience (list_vr_notifications).
+ *
+ * Read tools: Tier 0. Write tools: Tier 1 (WRITE_ENABLED=true).
+ * Verified against a live PDI (dev400464).
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getUsemSlaToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            record_type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            ttr_status: {
+                type: string;
+                description: string;
+            };
+            breached_only: {
+                type: string;
+                description: string;
+            };
+            due_within_days: {
+                type: string;
+                description: string;
+            };
+            assignment_group: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            display_value: {
+                description: string;
+                oneOf: ({
+                    type: string;
+                    enum?: undefined;
+                } | {
+                    type: string;
+                    enum: string[];
+                })[];
+            };
+            number_or_sysid?: undefined;
+            sys_id?: undefined;
+            commitment_date?: undefined;
+            active?: undefined;
+            table?: undefined;
+            name_contains?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            record_type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            number_or_sysid: {
+                type: string;
+                description: string;
+            };
+            ttr_status?: undefined;
+            breached_only?: undefined;
+            due_within_days?: undefined;
+            assignment_group?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            display_value?: undefined;
+            sys_id?: undefined;
+            commitment_date?: undefined;
+            active?: undefined;
+            table?: undefined;
+            name_contains?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            number_or_sysid: {
+                type: string;
+                description: string;
+            };
+            record_type?: undefined;
+            ttr_status?: undefined;
+            breached_only?: undefined;
+            due_within_days?: undefined;
+            assignment_group?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            display_value?: undefined;
+            sys_id?: undefined;
+            commitment_date?: undefined;
+            active?: undefined;
+            table?: undefined;
+            name_contains?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            record_type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            sys_id: {
+                type: string;
+                description: string;
+            };
+            commitment_date: {
+                type: string;
+                description: string;
+            };
+            ttr_status?: undefined;
+            breached_only?: undefined;
+            due_within_days?: undefined;
+            assignment_group?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            display_value?: undefined;
+            number_or_sysid?: undefined;
+            active?: undefined;
+            table?: undefined;
+            name_contains?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            active: {
+                type: string;
+                description: string;
+            };
+            table: {
+                type: string;
+                description: string;
+            };
+            name_contains: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            record_type?: undefined;
+            ttr_status?: undefined;
+            breached_only?: undefined;
+            due_within_days?: undefined;
+            assignment_group?: undefined;
+            query?: undefined;
+            display_value?: undefined;
+            number_or_sysid?: undefined;
+            sys_id?: undefined;
+            commitment_date?: undefined;
+        };
+        required?: undefined;
+    };
+})[];
+export declare function executeUsemSlaToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=usem-sla.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usem-sla.d.ts","sourceRoot":"","sources":["../../src/tools/usem-sla.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAyFhE,wBAAgB,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA6FxC;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CA4Jd"}