nowaikit 4.11.0 → 4.12.0

package/dist/tools/platform-ops.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Platform operations: Instance Scan findings, ECC queue, fix scripts.
+ * Read: Tier 0. Reprocess: Tier 1 (WRITE_ENABLED=true). Fix scripts: Tier 2 (SCRIPTING_ENABLED=true).
+ *
+ * Tables:
+ *   scan_suite       — Instance Scan suites
+ *   scan_finding     — Instance Scan best-practice findings
+ *   ecc_queue        — External Communication Channel queue (probes/sensors)
+ *   sys_script_fix   — fix scripts
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getPlatformOpsToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            check?: undefined;
+            suite_result?: undefined;
+            table?: undefined;
+            state?: undefined;
+            queue?: undefined;
+            agent?: undefined;
+            topic?: undefined;
+            sys_id?: undefined;
+            name?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            check: {
+                type: string;
+                description: string;
+            };
+            suite_result: {
+                type: string;
+                description: string;
+            };
+            table: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            query?: undefined;
+            state?: undefined;
+            queue?: undefined;
+            agent?: undefined;
+            topic?: undefined;
+            sys_id?: undefined;
+            name?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            state: {
+                type: string;
+                description: string;
+            };
+            queue: {
+                type: string;
+                description: string;
+            };
+            agent: {
+                type: string;
+                description: string;
+            };
+            topic: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            query?: undefined;
+            check?: undefined;
+            suite_result?: undefined;
+            table?: undefined;
+            sys_id?: undefined;
+            name?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            sys_id: {
+                type: string;
+                description: string;
+            };
+            query?: undefined;
+            limit?: undefined;
+            check?: undefined;
+            suite_result?: undefined;
+            table?: undefined;
+            state?: undefined;
+            queue?: undefined;
+            agent?: undefined;
+            topic?: undefined;
+            name?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            sys_id: {
+                type: string;
+                description: string;
+            };
+            query?: undefined;
+            limit?: undefined;
+            check?: undefined;
+            suite_result?: undefined;
+            table?: undefined;
+            state?: undefined;
+            queue?: undefined;
+            agent?: undefined;
+            topic?: undefined;
+        };
+        required: never[];
+    };
+})[];
+export declare function executePlatformOpsToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=platform-ops.d.ts.map

package/dist/tools/platform-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-ops.d.ts","sourceRoot":"","sources":["../../src/tools/platform-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,wBAAgB,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmE5C;AAED,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAyDd"}

package/dist/tools/platform-ops.js

@@ -0,0 +1,141 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireWrite, requireScripting } from '../utils/permissions.js';
+export function getPlatformOpsToolDefinitions() {
+    return [
+        {
+            name: 'list_scan_suites',
+            description: 'List Instance Scan suites (scan_suite) available to run',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Search suites by name' },
+                    limit: { type: 'number', description: 'Max records (default 50)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'get_instance_scan_findings',
+            description: 'List Instance Scan findings (scan_finding) — best-practice violations, optionally by check or suite result',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    check: { type: 'string', description: 'Filter by check name (contains)' },
+                    suite_result: { type: 'string', description: 'Filter by scan suite result sys_id' },
+                    table: { type: 'string', description: 'Filter by target table' },
+                    limit: { type: 'number', description: 'Max records (default 50)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'get_ecc_queue',
+            description: 'Inspect the ECC queue (ecc_queue) — MID server probes/sensors, by state, agent, or topic',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    state: { type: 'string', description: 'Filter by state (e.g. "ready", "processed", "error")' },
+                    queue: { type: 'string', description: 'Direction: "input" or "output"' },
+                    agent: { type: 'string', description: 'MID server agent name (contains)' },
+                    topic: { type: 'string', description: 'Topic (contains)' },
+                    limit: { type: 'number', description: 'Max records (default 50)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'resubmit_ecc_probe',
+            description: 'Re-queue an ECC probe/sensor by setting its state back to ready (ecc_queue). Requires WRITE_ENABLED=true',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'sys_id of the ecc_queue record' },
+                },
+                required: ['sys_id'],
+            },
+        },
+        {
+            name: 'run_fix_script',
+            description: 'Execute a fix script (sys_script_fix) by name or sys_id on the server. Requires WRITE_ENABLED=true and SCRIPTING_ENABLED=true',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Fix script name' },
+                    sys_id: { type: 'string', description: 'sys_id of the fix script' },
+                },
+                required: [],
+            },
+        },
+    ];
+}
+export async function executePlatformOpsToolCall(client, name, args) {
+    switch (name) {
+        case 'list_scan_suites': {
+            const query = args.query ? `nameCONTAINS${args.query}` : '';
+            return await client.queryRecords({ table: 'scan_suite', query, limit: args.limit ?? 50 });
+        }
+        case 'get_instance_scan_findings': {
+            const parts = [];
+            if (args.check)
+                parts.push(`check.nameCONTAINS${args.check}`);
+            if (args.suite_result)
+                parts.push(`suite_result=${args.suite_result}`);
+            if (args.table)
+                parts.push(`table=${args.table}`);
+            return await client.queryRecords({
+                table: 'scan_finding',
+                query: parts.join('^') + (parts.length ? '^' : '') + 'ORDERBYDESCsys_created_on',
+                fields: 'check,check.name,table,document,description,suite_result',
+                limit: args.limit ?? 50,
+            });
+        }
+        case 'get_ecc_queue': {
+            const parts = [];
+            if (args.state)
+                parts.push(`state=${args.state}`);
+            if (args.queue)
+                parts.push(`queue=${args.queue}`);
+            if (args.agent)
+                parts.push(`agentCONTAINS${args.agent}`);
+            if (args.topic)
+                parts.push(`topicCONTAINS${args.topic}`);
+            return await client.queryRecords({
+                table: 'ecc_queue',
+                query: parts.join('^') + (parts.length ? '^' : '') + 'ORDERBYDESCsys_created_on',
+                fields: 'agent,topic,name,source,queue,state,processed,error_string',
+                limit: args.limit ?? 50,
+            });
+        }
+        case 'resubmit_ecc_probe': {
+            requireWrite();
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            const result = await client.updateRecord('ecc_queue', args.sys_id, { state: 'ready' });
+            return { ...result, summary: `Re-queued ECC record ${args.sys_id}` };
+        }
+        case 'run_fix_script': {
+            requireScripting();
+            let fix;
+            if (args.sys_id) {
+                fix = await client.getRecord('sys_script_fix', args.sys_id);
+            }
+            else if (args.name) {
+                const resp = await client.queryRecords({ table: 'sys_script_fix', query: `name=${args.name}`, limit: 1 });
+                if (resp.count === 0)
+                    throw new ServiceNowError(`Fix script not found: ${args.name}`, 'NOT_FOUND');
+                fix = resp.records[0];
+            }
+            else {
+                throw new ServiceNowError('name or sys_id is required', 'INVALID_REQUEST');
+            }
+            const script = fix.script;
+            if (!script)
+                throw new ServiceNowError('Fix script has no script body', 'INVALID_REQUEST');
+            const output = await client.executeScript(script);
+            return { fix_script: fix.name, output, summary: `Executed fix script "${fix.name}"` };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=platform-ops.js.map

package/dist/tools/platform-ops.js.map

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

package/dist/tools/service-mapping.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Service Mapping / application-service tools — parity with ServiceNow's first-party
+ * CMDB (Service Mapping) MCP server. Read: Tier 0. Create: Tier 1 (WRITE_ENABLED=true).
+ *
+ * Tables:
+ *   cmdb_ci_service_auto — discovered application services
+ *   svc_ci_assoc         — CI ↔ application-service membership
+ *   cmdb_rel_ci          — CI relationships
+ *   cmdb_class_info      — CMDB class metadata (for class suggestion)
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getServiceMappingToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            operational_status: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            ci?: undefined;
+            ci_name?: undefined;
+            ci_class?: undefined;
+            keyword?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            ci: {
+                type: string;
+                description: string;
+            };
+            ci_name: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            query?: undefined;
+            operational_status?: undefined;
+            ci_class?: undefined;
+            keyword?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            ci_class: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            query?: undefined;
+            operational_status?: undefined;
+            ci?: undefined;
+            ci_name?: undefined;
+            keyword?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            keyword: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            query?: undefined;
+            operational_status?: undefined;
+            ci?: undefined;
+            ci_name?: undefined;
+            ci_class?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare function executeServiceMappingToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=service-mapping.d.ts.map

package/dist/tools/service-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-mapping.d.ts","sourceRoot":"","sources":["../../src/tools/service-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,wBAAgB,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAqD/C;AAED,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CA4Ed"}

package/dist/tools/service-mapping.js

@@ -0,0 +1,144 @@
+import { ServiceNowError } from '../utils/errors.js';
+export function getServiceMappingToolDefinitions() {
+    return [
+        {
+            name: 'list_application_services',
+            description: 'List discovered application services (cmdb_ci_service_auto), optionally by name or operational status. Parity with ServiceNow get_all_application_service_names',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Search application services by name' },
+                    operational_status: { type: 'string', description: 'Filter by operational_status value' },
+                    limit: { type: 'number', description: 'Max records (default 50)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'cmdb_services_for_ci',
+            description: 'Reverse lookup: which application services contain a given CI/server (svc_ci_assoc). Parity with ServiceNow get_all_application_services_for_a_server',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    ci: { type: 'string', description: 'sys_id of the CI/server' },
+                    ci_name: { type: 'string', description: 'CI name if sys_id not known' },
+                    limit: { type: 'number', description: 'Max records (default 50)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'cmdb_find_unmapped_cis',
+            description: 'Find operational CIs that have relationships but belong to no application service (mapping gaps). Parity with ServiceNow get_unmapped_topology',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    ci_class: { type: 'string', description: 'Restrict to a CI class/table (e.g. cmdb_ci_server)' },
+                    limit: { type: 'number', description: 'Max CIs to scan/return (default 100)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'suggest_ci_class',
+            description: 'Suggest the correct CMDB CI class for a keyword before creating a CI (cmdb_class_info). Parity with ServiceNow Get_SimilarCI_Classes',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    keyword: { type: 'string', description: 'Device/technology keyword, e.g. "linux server", "load balancer"' },
+                    limit: { type: 'number', description: 'Max classes to return (default 10)' },
+                },
+                required: ['keyword'],
+            },
+        },
+    ];
+}
+export async function executeServiceMappingToolCall(client, name, args) {
+    switch (name) {
+        case 'list_application_services': {
+            const parts = [];
+            if (args.operational_status)
+                parts.push(`operational_status=${args.operational_status}`);
+            if (args.query)
+                parts.push(`nameCONTAINS${args.query}`);
+            return await client.queryRecords({
+                table: 'cmdb_ci_service_auto',
+                query: parts.join('^'),
+                fields: 'name,sys_id,operational_status,service_classification,busines_criticality,short_description',
+                limit: args.limit ?? 50,
+            });
+        }
+        case 'cmdb_services_for_ci': {
+            let ciId = args.ci;
+            if (!ciId && args.ci_name) {
+                const r = await client.queryRecords({ table: 'cmdb_ci', query: `name=${args.ci_name}`, limit: 1 });
+                if (r.count === 0)
+                    throw new ServiceNowError(`CI not found: ${args.ci_name}`, 'NOT_FOUND');
+                ciId = r.records[0].sys_id;
+            }
+            if (!ciId)
+                throw new ServiceNowError('ci or ci_name is required', 'INVALID_REQUEST');
+            const assoc = await client.queryRecords({
+                table: 'svc_ci_assoc',
+                query: `ci_id=${ciId}`,
+                fields: 'cmdb_ci_service,cmdb_ci_service.name,ci_id,ci_id.name',
+                limit: args.limit ?? 50,
+            });
+            return { ci: ciId, services: assoc.records, count: assoc.count, note: 'Services this CI is a member of, via svc_ci_assoc.' };
+        }
+        case 'cmdb_find_unmapped_cis': {
+            const limit = args.limit ?? 100;
+            const ciQuery = ['operational_status=1'];
+            if (args.ci_class)
+                ciQuery.push(`sys_class_name=${args.ci_class}`);
+            const cis = await client.queryRecords({ table: 'cmdb_ci', query: ciQuery.join('^'), fields: 'sys_id,name,sys_class_name', limit });
+            const ciIds = cis.records.map((c) => c.sys_id);
+            if (ciIds.length === 0)
+                return { unmapped: [], count: 0, note: 'No operational CIs matched.' };
+            // Which of these CIs are already members of an application service?
+            const assoc = await client.queryRecords({ table: 'svc_ci_assoc', query: `ci_idIN${ciIds.join(',')}`, fields: 'ci_id', limit: 4000 }).catch(() => ({ records: [] }));
+            const mapped = new Set(assoc.records.map((r) => (r.ci_id && typeof r.ci_id === 'object' ? r.ci_id.value : r.ci_id)));
+            // Keep only CIs that have at least one relationship (i.e. real topology, just unmapped).
+            const rel = await client.queryRecords({ table: 'cmdb_rel_ci', query: `parentIN${ciIds.join(',')}^ORchildIN${ciIds.join(',')}`, fields: 'parent,child', limit: 4000 }).catch(() => ({ records: [] }));
+            const related = new Set();
+            for (const r of rel.records) {
+                for (const k of ['parent', 'child']) {
+                    const v = r[k] && typeof r[k] === 'object' ? r[k].value : r[k];
+                    if (v)
+                        related.add(v);
+                }
+            }
+            const unmapped = cis.records.filter((c) => !mapped.has(c.sys_id) && related.has(c.sys_id));
+            return {
+                scanned: ciIds.length,
+                count: unmapped.length,
+                unmapped,
+                note: 'Operational CIs with relationships (cmdb_rel_ci) but no application-service membership (svc_ci_assoc). Approximated via Table API; ServiceNow also factors observed TCP traffic.',
+            };
+        }
+        case 'suggest_ci_class': {
+            if (!args.keyword)
+                throw new ServiceNowError('keyword is required', 'INVALID_REQUEST');
+            const kw = String(args.keyword).trim();
+            let resp = await client.queryRecords({
+                table: 'cmdb_class_info',
+                query: `labelLIKE${kw}^ORnameLIKE${kw}`,
+                fields: 'name,label,super_class,sys_id',
+                limit: args.limit ?? 10,
+            }).catch(() => null);
+            if (!resp || resp.count === 0) {
+                // Fall back to the dictionary of tables extending cmdb_ci.
+                resp = await client.queryRecords({
+                    table: 'sys_db_object',
+                    query: `nameSTARTSWITHcmdb_ci^labelLIKE${kw}`,
+                    fields: 'name,label,super_class,sys_id',
+                    limit: args.limit ?? 10,
+                });
+            }
+            return { keyword: kw, suggested_classes: resp.records, count: resp.count, note: 'Use the class "name" as the table for create_record. Check required attributes with get_table_schema.' };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=service-mapping.js.map

package/dist/tools/service-mapping.js.map

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

package/dist/tools/service-portfolio.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Service Portfolio modeling: business services & service offerings.
+ * Read: Tier 0. Create: Tier 1 (WRITE_ENABLED=true).
+ *
+ * Tables:
+ *   cmdb_ci_service   — business services
+ *   service_offering  — service offerings (child of a business service)
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getServicePortfolioToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            owned_by: {
+                type: string;
+                description: string;
+            };
+            support_group: {
+                type: string;
+                description: string;
+            };
+            fields: {
+                type: string;
+                description: string;
+            };
+            parent?: undefined;
+            query?: undefined;
+            limit?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            parent: {
+                type: string;
+                description: string;
+            };
+            support_group: {
+                type: string;
+                description: string;
+            };
+            fields: {
+                type: string;
+                description: string;
+            };
+            owned_by?: undefined;
+            query?: undefined;
+            limit?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            parent: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            name?: undefined;
+            owned_by?: undefined;
+            support_group?: undefined;
+            fields?: undefined;
+        };
+        required: never[];
+    };
+})[];
+export declare function executeServicePortfolioToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=service-portfolio.d.ts.map

package/dist/tools/service-portfolio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-portfolio.d.ts","sourceRoot":"","sources":["../../src/tools/service-portfolio.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,wBAAgB,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4CjD;AAED,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CA6Bd"}