@tedorigawa001/servicenow-mcp 1.0.2

package/dist/tools/devops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devops.js","sourceRoot":"","sources":["../../src/tools/devops.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL;YACE,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EAAE,8DAA8D;YAC3E,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,2CAA2C,EAAE;oBACrF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;iBACnE;gBACD,QAAQ,EAAE,EAAE;aACb;SACF;QACD;YACE,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EAAE,2CAA2C;YACxD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE;iBAC3D;gBACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;aACrB;SACF;QACD;YACE,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,2DAA2D;YACxE,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;oBACtE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;oBAC9F,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qDAAqD,EAAE;oBAC7F,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;iBACnE;gBACD,QAAQ,EAAE,EAAE;aACb;SACF;QACD;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,iDAAiD;YAC9D,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;iBAC7D;gBACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;aACrB;SACF;QACD;YACE,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,0FAA0F;YACvG,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,iBAAiB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;oBAC9E,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;oBACpE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;oBACvF,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;oBACpF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;oBACjF,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE;oBAC3D,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;iBAClE;gBACD,QAAQ,EAAE,CAAC,mBAAmB,EAAE,aAAa,CAAC;aAC/C;SACF;QACD;YACE,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,sFAAsF;YACnG,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;oBACpE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;oBAClE,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;oBAC9E,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;oBAC5E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iDAAiD,EAAE;oBAC1F,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;iBAC3D;gBACD,QAAQ,EAAE,CAAC,aAAa,EAAE,eAAe,EAAE,QAAQ,CAAC;aACrD;SACF;QACD;YACE,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EAAE,8EAA8E;YAC3F,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uDAAuD,EAAE;oBACzG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE;iBAChF;gBACD,QAAQ,EAAE,EAAE;aACb;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAwB,EACxB,IAAY,EACZ,IAAyB;IAEzB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,uBAAuB,CAAC,CAAC,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;gBACrC,KAAK,EAAE,oBAAoB;gBAC3B,KAAK,EAAE,KAAK,IAAI,SAAS;gBACzB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;gBACvB,MAAM,EAAE,oDAAoD;aAC7D,CAAC,CAAC;YACH,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACxD,CAAC;QAED,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,eAAe,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAC;YACrF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,oBAAoB,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACzE,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,IAAI,KAAK,GAAG,EAAE,CAAC;YACf,IAAI,IAAI,CAAC,eAAe;gBAAE,KAAK,GAAG,YAAY,IAAI,CAAC,eAAe,EAAE,CAAC;YACrE,IAAI,IAAI,CAAC,WAAW;gBAAE,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,UAAU,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,WAAW,EAAE,CAAC;YACzG,IAAI,IAAI,CAAC,KAAK;gBAAE,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,WAAW,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;YACzF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;gBACrC,KAAK,EAAE,uBAAuB;gBAC9B,KAAK,EAAE,KAAK,IAAI,SAAS;gBACzB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;gBACvB,MAAM,EAAE,gGAAgG;aACzG,CAAC,CAAC;YACH,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAC1D,CAAC;QAED,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,eAAe,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAC;YACrF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,uBAAuB,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAC5E,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,sBAAsB,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjD,MAAM,IAAI,eAAe,CAAC,gDAAgD,EAAE,iBAAiB,CAAC,CAAC;YACjG,CAAC;YACD,YAAY,EAAE,CAAC;YACf,MAAM,OAAO,GAAwB;gBACnC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;gBACzC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,UAAU;gBAC7B,WAAW,EAAE,wBAAwB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;aACrG,CAAC;YACF,IAAI,IAAI,CAAC,WAAW;gBAAE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;YAC7D,IAAI,IAAI,CAAC,gBAAgB;gBAAE,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;YAC5E,uDAAuD;YACvD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;YACpE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,MAAM,EAAE,CAAC;QACzE,CAAC;QAED,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC7D,MAAM,IAAI,eAAe,CAAC,qDAAqD,EAAE,iBAAiB,CAAC,CAAC;YACtG,CAAC;YACD,YAAY,EAAE,CAAC;YACf,MAAM,OAAO,GAAwB;gBACnC,KAAK,EAAE,IAAI,CAAC,WAAW;gBACvB,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC;YACF,IAAI,IAAI,CAAC,QAAQ;gBAAE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YACpD,IAAI,IAAI,CAAC,gBAAgB;gBAAE,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;YAC5E,IAAI,IAAI,CAAC,KAAK;gBAAE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC;YACjD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;YAC3E,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QAC5H,CAAC;QAED,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAClG,IAAI,KAAK,GAAG,mBAAmB,KAAK,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,eAAe;gBAAE,KAAK,IAAI,aAAa,IAAI,CAAC,eAAe,EAAE,CAAC;YACvE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;gBACrC,KAAK,EAAE,uBAAuB;gBAC9B,KAAK;gBACL,KAAK,EAAE,IAAI;gBACX,MAAM,EAAE,uBAAuB;aAChC,CAAC,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;YAC/E,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;YAC7E,OAAO;gBACL,WAAW,EAAE,IAAI;gBACjB,iBAAiB,EAAE,KAAK;gBACxB,UAAU,EAAE,OAAO;gBACnB,MAAM;gBACN,YAAY,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK;gBAC3E,YAAY,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK;gBAC1E,oBAAoB,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK;gBAChF,IAAI,EAAE,uFAAuF;aAC9F,CAAC;QACJ,CAAC;QAED;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/tools/discovery.d.ts

@@ -0,0 +1,306 @@
+/**
+ * Discovery & ACC (Agent Client Collector) tools — run history, per-device
+ * results, logs, IP ranges, credential metadata, MID Server health, and
+ * ACC agent/policy/check visibility.
+ *
+ * Tier 0 (Read): list_discovery_runs, get_discovery_run, list_discovered_devices,
+ *                 list_discovery_logs, list_discovery_ranges, list_discovery_credentials,
+ *                 list_mid_server_issues, get_mid_server_health,
+ *                 list_acc_agents, list_acc_policies, list_acc_checks
+ *
+ * ServiceNow tables: discovery_status, discovery_device_history, discovery_log,
+ *                     discovery_range_item, discovery_credentials,
+ *                     ecc_agent, ecc_agent_issue, ecc_queue,
+ *                     sn_agent_cmdb_ci_agent, sn_agent_policy, sn_agent_check (ACC plugin)
+ *
+ * Complements core.ts (list_discovery_schedules, list_mid_servers, run_discovery_scan):
+ * this module covers what happened AFTER a scan is triggered — results, errors,
+ * and infrastructure health.
+ *
+ * Note: list_discovery_credentials returns metadata only (name/type/order/scope) —
+ * secret fields (password, ssh_private_key, ...) are never requested.
+ * ACC tools require the Agent Client Collector plugin; without it they raise a
+ * clear PLUGIN_NOT_INSTALLED error instead of a generic 400.
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getDiscoveryToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            state: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            run_id?: undefined;
+            with_issues_only?: undefined;
+            source?: undefined;
+            device_history_id?: undefined;
+            active?: undefined;
+            type?: undefined;
+            mid_server?: undefined;
+            status?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            run_id: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            with_issues_only?: undefined;
+            source?: undefined;
+            device_history_id?: undefined;
+            active?: undefined;
+            type?: undefined;
+            mid_server?: undefined;
+            status?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            run_id: {
+                type: string;
+                description: string;
+            };
+            with_issues_only: {
+                type: string;
+                description: string;
+            };
+            source: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            query?: undefined;
+            device_history_id?: undefined;
+            active?: undefined;
+            type?: undefined;
+            mid_server?: undefined;
+            status?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            run_id: {
+                type: string;
+                description: string;
+            };
+            device_history_id: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            with_issues_only?: undefined;
+            source?: undefined;
+            active?: undefined;
+            type?: undefined;
+            mid_server?: undefined;
+            status?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            active: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            query?: undefined;
+            run_id?: undefined;
+            with_issues_only?: undefined;
+            source?: undefined;
+            device_history_id?: undefined;
+            type?: undefined;
+            mid_server?: undefined;
+            status?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            type: {
+                type: string;
+                description: string;
+            };
+            active: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            query?: undefined;
+            run_id?: undefined;
+            with_issues_only?: undefined;
+            source?: undefined;
+            device_history_id?: undefined;
+            mid_server?: undefined;
+            status?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            mid_server: {
+                type: string;
+                description: string;
+            };
+            state: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            query?: undefined;
+            run_id?: undefined;
+            with_issues_only?: undefined;
+            source?: undefined;
+            device_history_id?: undefined;
+            active?: undefined;
+            type?: undefined;
+            status?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            mid_server: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            run_id?: undefined;
+            with_issues_only?: undefined;
+            source?: undefined;
+            device_history_id?: undefined;
+            active?: undefined;
+            type?: undefined;
+            status?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            status: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            run_id?: undefined;
+            with_issues_only?: undefined;
+            source?: undefined;
+            device_history_id?: undefined;
+            active?: undefined;
+            type?: undefined;
+            mid_server?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            run_id?: undefined;
+            with_issues_only?: undefined;
+            source?: undefined;
+            device_history_id?: undefined;
+            active?: undefined;
+            type?: undefined;
+            mid_server?: undefined;
+            status?: undefined;
+        };
+        required: never[];
+    };
+})[];
+export declare function executeDiscoveryToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/tools/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAyBhE,wBAAgB,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA6I1C;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,CAiMd"}

package/dist/tools/discovery.js

@@ -0,0 +1,357 @@
+import { ServiceNowError } from '../utils/errors.js';
+const SYS_ID_RE = /^[0-9a-f]{32}$/i;
+/** ACC tables only exist when the Agent Client Collector plugin is installed. */
+async function queryAccTable(client, params) {
+    try {
+        return await client.queryRecords(params);
+    }
+    catch (e) {
+        const msg = String(e?.message ?? '');
+        if (/invalid table|not authorized|400/i.test(msg)) {
+            throw new ServiceNowError(`Table "${params.table}" is unavailable — the Agent Client Collector (ACC) plugin ` +
+                'does not appear to be installed on this instance.', 'PLUGIN_NOT_INSTALLED');
+        }
+        throw e;
+    }
+}
+export function getDiscoveryToolDefinitions() {
+    return [
+        {
+            name: 'list_discovery_runs',
+            description: 'List Discovery run history (discovery_status) — state, duration, and progress per scan, newest first',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    state: { type: 'string', description: 'Filter by run state (e.g. "Active", "Complete", "Cancelled")' },
+                    query: { type: 'string', description: 'Additional encoded query' },
+                    limit: { type: 'number', description: 'Max records (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'get_discovery_run',
+            description: 'Get one Discovery run by sys_id or number (DIS...), including full status fields',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    run_id: { type: 'string', description: 'discovery_status sys_id or number (e.g. "DIS0001001")' },
+                },
+                required: ['run_id'],
+            },
+        },
+        {
+            name: 'list_discovered_devices',
+            description: 'List per-device Discovery results (discovery_device_history) — classification, resulting CI, and issue count. Use to answer "why was this server not discovered?"',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    run_id: { type: 'string', description: 'Filter by parent discovery_status sys_id or number' },
+                    with_issues_only: { type: 'boolean', description: 'Only devices that reported issues' },
+                    source: { type: 'string', description: 'Filter by device IP / source (LIKE match)' },
+                    limit: { type: 'number', description: 'Max records (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'list_discovery_logs',
+            description: 'List Discovery log entries (discovery_log) — sensor/probe messages with result codes, newest first',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    run_id: { type: 'string', description: 'Filter by parent discovery_status sys_id' },
+                    device_history_id: { type: 'string', description: 'Filter by discovery_device_history sys_id' },
+                    query: { type: 'string', description: 'Additional encoded query (e.g. "short_messageLIKEcredential")' },
+                    limit: { type: 'number', description: 'Max records (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'list_discovery_ranges',
+            description: 'List Discovery IP ranges (discovery_range_item) — which IP ranges/networks are scanned',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    active: { type: 'boolean', description: 'Filter by active flag' },
+                    limit: { type: 'number', description: 'Max records (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'list_discovery_credentials',
+            description: 'List Discovery credential METADATA (name, type, order, MID scope) — secret fields are never returned',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    type: { type: 'string', description: 'Filter by credential type (e.g. "Windows", "SSH", "SNMP")' },
+                    active: { type: 'boolean', description: 'Filter by active flag' },
+                    limit: { type: 'number', description: 'Max records (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'list_mid_server_issues',
+            description: 'List MID Server issues (ecc_agent_issue) — detected problems with source, occurrence count, and last-detected time',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    mid_server: { type: 'string', description: 'Filter by MID Server name or sys_id' },
+                    state: { type: 'string', description: 'Filter by issue state (e.g. "New", "Resolved")' },
+                    limit: { type: 'number', description: 'Max records (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'get_mid_server_health',
+            description: 'MID Server health summary — status, version, last refresh, open issues, and output-queue backlog sample',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    mid_server: { type: 'string', description: 'MID Server name or sys_id' },
+                },
+                required: ['mid_server'],
+            },
+        },
+        {
+            name: 'list_acc_agents',
+            description: 'List ACC (Agent Client Collector) agents and their status. Requires the ACC plugin',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    status: { type: 'string', description: 'Filter by agent status (e.g. "up", "down")' },
+                    query: { type: 'string', description: 'Additional encoded query' },
+                    limit: { type: 'number', description: 'Max records (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'list_acc_policies',
+            description: 'List ACC monitoring/check policies. Requires the ACC plugin',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    active: { type: 'boolean', description: 'Filter by active flag' },
+                    limit: { type: 'number', description: 'Max records (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'list_acc_checks',
+            description: 'List ACC check definitions. Requires the ACC plugin',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Encoded query filter' },
+                    limit: { type: 'number', description: 'Max records (default 25)' },
+                },
+                required: [],
+            },
+        },
+    ];
+}
+export async function executeDiscoveryToolCall(client, name, args) {
+    switch (name) {
+        case 'list_discovery_runs': {
+            let query = '';
+            if (args.state)
+                query = `state=${args.state}`;
+            if (args.query)
+                query = query ? `${query}^${args.query}` : args.query;
+            query = query ? `${query}^ORDERBYDESCsys_created_on` : 'ORDERBYDESCsys_created_on';
+            const resp = await client.queryRecords({
+                table: 'discovery_status',
+                query,
+                limit: args.limit || 25,
+                display_value: true,
+                fields: 'sys_id,number,state,description,dscheduler,source,started,completed,duration,progress,max_run,sys_created_on',
+            });
+            return { count: resp.count, runs: resp.records };
+        }
+        case 'get_discovery_run': {
+            if (!args.run_id)
+                throw new ServiceNowError('run_id is required', 'INVALID_REQUEST');
+            if (SYS_ID_RE.test(args.run_id)) {
+                return await client.getRecord('discovery_status', args.run_id);
+            }
+            const resp = await client.queryRecords({
+                table: 'discovery_status',
+                query: `number=${args.run_id}`,
+                limit: 1,
+                display_value: true,
+            });
+            if (resp.count === 0)
+                throw new ServiceNowError(`Discovery run not found: ${args.run_id}`, 'NOT_FOUND');
+            return resp.records[0];
+        }
+        case 'list_discovered_devices': {
+            let query = '';
+            if (args.run_id) {
+                const statusRef = SYS_ID_RE.test(args.run_id) ? `status=${args.run_id}` : `status.number=${args.run_id}`;
+                query = statusRef;
+            }
+            if (args.with_issues_only)
+                query = query ? `${query}^issues>0` : 'issues>0';
+            if (args.source)
+                query = query ? `${query}^sourceLIKE${args.source}` : `sourceLIKE${args.source}`;
+            query = query ? `${query}^ORDERBYDESCsys_created_on` : 'ORDERBYDESCsys_created_on';
+            const resp = await client.queryRecords({
+                table: 'discovery_device_history',
+                query,
+                limit: args.limit || 25,
+                display_value: true,
+                fields: 'sys_id,source,dns_name,scan_status,current_state,last_state,classified_as,cmdb_ci,issues,issues_link,started,completed,status',
+            });
+            return { count: resp.count, devices: resp.records };
+        }
+        case 'list_discovery_logs': {
+            let query = '';
+            if (args.run_id)
+                query = `status=${args.run_id}`;
+            if (args.device_history_id)
+                query = query ? `${query}^device_history=${args.device_history_id}` : `device_history=${args.device_history_id}`;
+            if (args.query)
+                query = query ? `${query}^${args.query}` : args.query;
+            query = query ? `${query}^ORDERBYDESCcreated_on` : 'ORDERBYDESCcreated_on';
+            const resp = await client.queryRecords({
+                table: 'discovery_log',
+                query,
+                limit: args.limit || 25,
+                display_value: true,
+                fields: 'sys_id,created_on,short_message,result_code,sensor,cmdb_ci,device_history,status',
+            });
+            return { count: resp.count, logs: resp.records };
+        }
+        case 'list_discovery_ranges': {
+            let query = '';
+            if (args.active !== undefined)
+                query = `active=${args.active}`;
+            const resp = await client.queryRecords({
+                table: 'discovery_range_item',
+                query: query || undefined,
+                limit: args.limit || 25,
+                display_value: true,
+                fields: 'sys_id,name,type,active,start_ip_address,end_ip_address,network_ip,netmask,parent,summary',
+            });
+            return { count: resp.count, ranges: resp.records };
+        }
+        case 'list_discovery_credentials': {
+            let query = '';
+            if (args.type)
+                query = `type=${args.type}`;
+            if (args.active !== undefined)
+                query = query ? `${query}^active=${args.active}` : `active=${args.active}`;
+            const resp = await client.queryRecords({
+                table: 'discovery_credentials',
+                query: query || undefined,
+                limit: args.limit || 25,
+                display_value: true,
+                // Metadata only — never request password / ssh_private_key / authentication_key etc.
+                fields: 'sys_id,name,type,sys_class_name,active,order,applies_to,user_name,classification,tag,sys_updated_on',
+            });
+            return { count: resp.count, credentials: resp.records };
+        }
+        case 'list_mid_server_issues': {
+            let query = '';
+            if (args.mid_server) {
+                query = SYS_ID_RE.test(args.mid_server)
+                    ? `mid_server=${args.mid_server}`
+                    : `mid_server.name=${args.mid_server}`;
+            }
+            if (args.state)
+                query = query ? `${query}^state=${args.state}` : `state=${args.state}`;
+            query = query ? `${query}^ORDERBYDESClast_detected` : 'ORDERBYDESClast_detected';
+            const resp = await client.queryRecords({
+                table: 'ecc_agent_issue',
+                query,
+                limit: args.limit || 25,
+                display_value: true,
+                fields: 'sys_id,mid_server,message,source,state,count,last_detected,sys_created_on',
+            });
+            return { count: resp.count, issues: resp.records };
+        }
+        case 'get_mid_server_health': {
+            if (!args.mid_server)
+                throw new ServiceNowError('mid_server is required', 'INVALID_REQUEST');
+            const midQuery = SYS_ID_RE.test(args.mid_server)
+                ? `sys_id=${args.mid_server}`
+                : `name=${args.mid_server}`;
+            const midResp = await client.queryRecords({
+                table: 'ecc_agent',
+                query: midQuery,
+                limit: 1,
+                display_value: true,
+                fields: 'sys_id,name,status,version,ip_address,host_name,last_refreshed,started,stopped,validated,unresolved_issues,timezone,host_os_distribution,host_os_version',
+            });
+            if (midResp.count === 0)
+                throw new ServiceNowError(`MID Server not found: ${args.mid_server}`, 'NOT_FOUND');
+            const mid = midResp.records[0];
+            const issuesResp = await client.queryRecords({
+                table: 'ecc_agent_issue',
+                query: `mid_server=${mid.sys_id}^state!=Resolved^ORDERBYDESClast_detected`,
+                limit: 25,
+                display_value: true,
+                fields: 'sys_id,message,source,state,count,last_detected',
+            });
+            // Output-queue backlog: jobs handed to this MID that it has not picked up yet.
+            // Sampled (capped at 100) — queryRecords count is page size, not a table count.
+            const backlogResp = await client.queryRecords({
+                table: 'ecc_queue',
+                query: `agent=mid.server.${mid.name}^queue=output^state=ready`,
+                limit: 100,
+                fields: 'sys_id',
+            });
+            return {
+                mid_server: mid,
+                open_issue_count: issuesResp.count,
+                open_issues: issuesResp.records,
+                output_queue_backlog_sample: backlogResp.count,
+                output_queue_backlog_note: backlogResp.count >= 100 ? '100+ (sample capped at 100)' : String(backlogResp.count),
+            };
+        }
+        case 'list_acc_agents': {
+            let query = '';
+            if (args.status)
+                query = `status=${args.status}`;
+            if (args.query)
+                query = query ? `${query}^${args.query}` : args.query;
+            const resp = await queryAccTable(client, {
+                table: 'sn_agent_cmdb_ci_agent',
+                query: query || undefined,
+                limit: args.limit || 25,
+                display_value: true,
+            });
+            return { count: resp.count, agents: resp.records };
+        }
+        case 'list_acc_policies': {
+            let query = '';
+            if (args.active !== undefined)
+                query = `active=${args.active}`;
+            const resp = await queryAccTable(client, {
+                table: 'sn_agent_policy',
+                query: query || undefined,
+                limit: args.limit || 25,
+                display_value: true,
+            });
+            return { count: resp.count, policies: resp.records };
+        }
+        case 'list_acc_checks': {
+            const resp = await queryAccTable(client, {
+                table: 'sn_agent_check',
+                query: args.query || undefined,
+                limit: args.limit || 25,
+                display_value: true,
+            });
+            return { count: resp.count, checks: resp.records };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=discovery.js.map