@tedorigawa001/servicenow-mcp 1.0.2

package/dist/tools/usem.d.ts

@@ -0,0 +1,489 @@
+/**
+ * USEM (Unified Security Exposure Management) tools — the modern successor to
+ * Vulnerability Response. Covers Vulnerable Items (VI), Remediation Tasks (RT),
+ * and NVD entries under the `sn_vul_` table family.
+ *
+ * Read tools: Tier 0. Write tools: Tier 1 (WRITE_ENABLED=true).
+ * Required roles: `sn_vul.read` (read), `sn_vul.write` (write).
+ *
+ * Tables and fields were verified against a live PDI (dev400464):
+ *   - sn_vul_vulnerable_item   (VI)  — human key: `number` (VITxxxxxxx)
+ *   - sn_vul_remediation_task  (RT)  — human key: `task_number`
+ *   - sn_vul_nvd_entry         (NVD) — CVE key: `id` (CVE-YYYY-NNNN)
+ *   - sn_vul_m2m_vul_group_item ("Remediation Task Item") — VI ↔ group/RT m2m
+ *       columns: `sn_vul_vulnerability` (group), `sn_vul_vulnerable_item` (VI)
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getUsemToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            state: {
+                type: string;
+                description: string;
+            };
+            risk_score_min: {
+                type: string;
+                description: string;
+            };
+            cmdb_ci: {
+                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;
+            assigned_to?: undefined;
+            short_description?: undefined;
+            description?: undefined;
+            ttr_target_date?: undefined;
+            sys_id?: undefined;
+            cve?: undefined;
+            score_min?: undefined;
+            top?: undefined;
+            sn_vul_entry?: undefined;
+            remediation_group?: undefined;
+            vulnerable_item?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            number_or_sysid: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            risk_score_min?: undefined;
+            cmdb_ci?: undefined;
+            assignment_group?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            display_value?: undefined;
+            assigned_to?: undefined;
+            short_description?: undefined;
+            description?: undefined;
+            ttr_target_date?: undefined;
+            sys_id?: undefined;
+            cve?: undefined;
+            score_min?: undefined;
+            top?: undefined;
+            sn_vul_entry?: undefined;
+            remediation_group?: undefined;
+            vulnerable_item?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            state: {
+                type: string;
+                description: string;
+            };
+            assignment_group: {
+                type: string;
+                description: string;
+            };
+            assigned_to: {
+                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[];
+                })[];
+            };
+            risk_score_min?: undefined;
+            cmdb_ci?: undefined;
+            number_or_sysid?: undefined;
+            short_description?: undefined;
+            description?: undefined;
+            ttr_target_date?: undefined;
+            sys_id?: undefined;
+            cve?: undefined;
+            score_min?: undefined;
+            top?: undefined;
+            sn_vul_entry?: undefined;
+            remediation_group?: undefined;
+            vulnerable_item?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            state: {
+                type: string;
+                description: string;
+            };
+            risk_score_min: {
+                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[];
+                })[];
+            };
+            cmdb_ci?: undefined;
+            number_or_sysid?: undefined;
+            assigned_to?: undefined;
+            short_description?: undefined;
+            description?: undefined;
+            ttr_target_date?: undefined;
+            sys_id?: undefined;
+            cve?: undefined;
+            score_min?: undefined;
+            top?: undefined;
+            sn_vul_entry?: undefined;
+            remediation_group?: undefined;
+            vulnerable_item?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            short_description: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            assignment_group: {
+                type: string;
+                description: string;
+            };
+            assigned_to: {
+                type: string;
+                description: string;
+            };
+            state: {
+                type: string;
+                description: string;
+            };
+            ttr_target_date: {
+                type: string;
+                description: string;
+            };
+            risk_score_min?: undefined;
+            cmdb_ci?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            display_value?: undefined;
+            number_or_sysid?: undefined;
+            sys_id?: undefined;
+            cve?: undefined;
+            score_min?: undefined;
+            top?: undefined;
+            sn_vul_entry?: undefined;
+            remediation_group?: undefined;
+            vulnerable_item?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            sys_id: {
+                type: string;
+                description: string;
+            };
+            state: {
+                type: string;
+                description: string;
+            };
+            assignment_group: {
+                type: string;
+                description: string;
+            };
+            assigned_to: {
+                type: string;
+                description: string;
+            };
+            short_description: {
+                type: string;
+                description: string;
+            };
+            ttr_target_date: {
+                type: string;
+                description: string;
+            };
+            risk_score_min?: undefined;
+            cmdb_ci?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            display_value?: undefined;
+            number_or_sysid?: undefined;
+            description?: undefined;
+            cve?: undefined;
+            score_min?: undefined;
+            top?: undefined;
+            sn_vul_entry?: undefined;
+            remediation_group?: undefined;
+            vulnerable_item?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            cve: {
+                type: string;
+                description: string;
+            };
+            score_min: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            risk_score_min?: undefined;
+            cmdb_ci?: undefined;
+            assignment_group?: undefined;
+            display_value?: undefined;
+            number_or_sysid?: undefined;
+            assigned_to?: undefined;
+            short_description?: undefined;
+            description?: undefined;
+            ttr_target_date?: undefined;
+            sys_id?: undefined;
+            top?: undefined;
+            sn_vul_entry?: undefined;
+            remediation_group?: undefined;
+            vulnerable_item?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            cve: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            risk_score_min?: undefined;
+            cmdb_ci?: undefined;
+            assignment_group?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            display_value?: undefined;
+            number_or_sysid?: undefined;
+            assigned_to?: undefined;
+            short_description?: undefined;
+            description?: undefined;
+            ttr_target_date?: undefined;
+            sys_id?: undefined;
+            score_min?: undefined;
+            top?: undefined;
+            sn_vul_entry?: undefined;
+            remediation_group?: undefined;
+            vulnerable_item?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            top: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            risk_score_min?: undefined;
+            cmdb_ci?: undefined;
+            assignment_group?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            display_value?: undefined;
+            number_or_sysid?: undefined;
+            assigned_to?: undefined;
+            short_description?: undefined;
+            description?: undefined;
+            ttr_target_date?: undefined;
+            sys_id?: undefined;
+            cve?: undefined;
+            score_min?: undefined;
+            sn_vul_entry?: undefined;
+            remediation_group?: undefined;
+            vulnerable_item?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            short_description: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            assignment_group: {
+                type: string;
+                description: string;
+            };
+            assigned_to: {
+                type: string;
+                description: string;
+            };
+            cmdb_ci: {
+                type: string;
+                description: string;
+            };
+            sn_vul_entry: {
+                type: string;
+                description: string;
+            };
+            state: {
+                type: string;
+                description: string;
+            };
+            ttr_target_date: {
+                type: string;
+                description: string;
+            };
+            risk_score_min?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            display_value?: undefined;
+            number_or_sysid?: undefined;
+            sys_id?: undefined;
+            cve?: undefined;
+            score_min?: undefined;
+            top?: undefined;
+            remediation_group?: undefined;
+            vulnerable_item?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            remediation_group: {
+                type: string;
+                description: string;
+            };
+            vulnerable_item: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            risk_score_min?: undefined;
+            cmdb_ci?: undefined;
+            assignment_group?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            display_value?: undefined;
+            number_or_sysid?: undefined;
+            assigned_to?: undefined;
+            short_description?: undefined;
+            description?: undefined;
+            ttr_target_date?: undefined;
+            sys_id?: undefined;
+            cve?: undefined;
+            score_min?: undefined;
+            top?: undefined;
+            sn_vul_entry?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare function executeUsemToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=usem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usem.d.ts","sourceRoot":"","sources":["../../src/tools/usem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AA0ChE,wBAAgB,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAuOrC;AA6BD,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAkOd"}