nowaikit 3.0.0 → 4.0.0

package/dist/tools/ai-agents.js

@@ -0,0 +1,185 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireNowAssist, requireWrite } from '../utils/permissions.js';
+export function getAiAgentsToolDefinitions() {
+    return [
+        {
+            name: 'create_ai_agent',
+            description: 'Create an AI agent definition with optional auto-generated ACLs (requires NOW_ASSIST_ENABLED + WRITE_ENABLED)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Agent name' },
+                    description: { type: 'string', description: 'Agent description' },
+                    capabilities: { type: 'array', items: { type: 'string' }, description: 'List of capability identifiers the agent supports' },
+                    auto_generate_acls: { type: 'boolean', description: 'Automatically create ACL records for the agent (default true)' },
+                },
+                required: ['name', 'description', 'capabilities'],
+            },
+        },
+        {
+            name: 'list_ai_agents',
+            description: 'List AI agent definitions',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    active: { type: 'boolean', description: 'Filter by active status' },
+                    limit: { type: 'number', description: 'Max records to return (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'get_ai_agent',
+            description: 'Get an AI agent definition and its related ACLs',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'System ID of the AI agent' },
+                },
+                required: ['sys_id'],
+            },
+        },
+        {
+            name: 'create_agentic_workflow',
+            description: 'Create an agentic workflow linked to an AI agent (requires NOW_ASSIST_ENABLED + WRITE_ENABLED)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Workflow name' },
+                    description: { type: 'string', description: 'Workflow description' },
+                    agent_sys_id: { type: 'string', description: 'System ID of the parent AI agent' },
+                    steps: {
+                        type: 'array',
+                        description: 'Ordered list of workflow steps',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                name: { type: 'string', description: 'Step name' },
+                                action: { type: 'string', description: 'Action identifier' },
+                                inputs: { type: 'object', description: 'Step input parameters' },
+                                condition: { type: 'string', description: 'Optional condition expression' },
+                            },
+                            required: ['name', 'action'],
+                        },
+                    },
+                    trigger_conditions: { type: 'string', description: 'Optional trigger condition expression' },
+                },
+                required: ['name', 'description', 'agent_sys_id', 'steps'],
+            },
+        },
+    ];
+}
+const AI_AGENT_TOOL_NAMES = new Set([
+    'create_ai_agent', 'list_ai_agents', 'get_ai_agent', 'create_agentic_workflow',
+]);
+export async function executeAiAgentsToolCall(client, name, args) {
+    if (!AI_AGENT_TOOL_NAMES.has(name))
+        return null;
+    switch (name) {
+        case 'create_ai_agent': {
+            requireNowAssist();
+            requireWrite();
+            if (!args.name)
+                throw new ServiceNowError('name is required', 'INVALID_REQUEST');
+            if (!args.description)
+                throw new ServiceNowError('description is required', 'INVALID_REQUEST');
+            if (!args.capabilities || !Array.isArray(args.capabilities)) {
+                throw new ServiceNowError('capabilities must be an array of strings', 'INVALID_REQUEST');
+            }
+            const agentData = {
+                name: args.name,
+                description: args.description,
+                capabilities: args.capabilities.join(','),
+                active: true,
+            };
+            const agentRecord = await client.createRecord('sys_ai_agent', agentData);
+            const agentSysId = String(agentRecord.sys_id);
+            const autoAcls = args.auto_generate_acls !== false;
+            const createdAcls = [];
+            if (autoAcls) {
+                // Create read ACL for the agent
+                const readAcl = await client.createRecord('sys_security_acl', {
+                    name: `${args.name} - Read`,
+                    type: 'record',
+                    operation: 'read',
+                    admin_overrides: true,
+                    active: true,
+                    description: `Auto-generated read ACL for AI agent: ${args.name}`,
+                    condition: `sys_ai_agent=${agentSysId}`,
+                });
+                createdAcls.push(readAcl);
+                // Create write ACL for the agent
+                const writeAcl = await client.createRecord('sys_security_acl', {
+                    name: `${args.name} - Write`,
+                    type: 'record',
+                    operation: 'write',
+                    admin_overrides: true,
+                    active: true,
+                    description: `Auto-generated write ACL for AI agent: ${args.name}`,
+                    condition: `sys_ai_agent=${agentSysId}`,
+                });
+                createdAcls.push(writeAcl);
+            }
+            return {
+                message: 'AI agent created',
+                agent: agentRecord,
+                acls_created: createdAcls.length,
+                acls: createdAcls,
+            };
+        }
+        case 'list_ai_agents': {
+            const parts = [];
+            if (args.active !== undefined)
+                parts.push(`active=${args.active}`);
+            const query = parts.length > 0 ? parts.join('^') : undefined;
+            const resp = await client.queryRecords({
+                table: 'sys_ai_agent',
+                query,
+                limit: args.limit || 25,
+                fields: 'sys_id,name,description,capabilities,active,sys_updated_on',
+            });
+            return { count: resp.count, agents: resp.records };
+        }
+        case 'get_ai_agent': {
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            const agent = await client.getRecord('sys_ai_agent', args.sys_id);
+            const agentSysId = String(agent.sys_id);
+            // Fetch related ACLs
+            const aclResp = await client.queryRecords({
+                table: 'sys_security_acl',
+                query: `conditionLIKEsys_ai_agent=${agentSysId}`,
+                limit: 20,
+                fields: 'sys_id,name,type,operation,active,description',
+            });
+            return { agent, acls: aclResp.records, acl_count: aclResp.count };
+        }
+        case 'create_agentic_workflow': {
+            requireNowAssist();
+            requireWrite();
+            if (!args.name)
+                throw new ServiceNowError('name is required', 'INVALID_REQUEST');
+            if (!args.description)
+                throw new ServiceNowError('description is required', 'INVALID_REQUEST');
+            if (!args.agent_sys_id)
+                throw new ServiceNowError('agent_sys_id is required', 'INVALID_REQUEST');
+            if (!args.steps || !Array.isArray(args.steps)) {
+                throw new ServiceNowError('steps must be an array', 'INVALID_REQUEST');
+            }
+            const workflowData = {
+                name: args.name,
+                description: args.description,
+                agent: args.agent_sys_id,
+                steps: JSON.stringify(args.steps),
+                active: true,
+            };
+            if (args.trigger_conditions)
+                workflowData.trigger_conditions = args.trigger_conditions;
+            const record = await client.createRecord('sys_ai_agentic_workflow', workflowData);
+            return { message: 'Agentic workflow created', workflow: record };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=ai-agents.js.map

package/dist/tools/ai-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-agents.js","sourceRoot":"","sources":["../../src/tools/ai-agents.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEzE,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EAAE,+GAA+G;YAC5H,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;oBACnD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;oBACjE,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,mDAAmD,EAAE;oBAC5H,kBAAkB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,+DAA+D,EAAE;iBACtH;gBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,cAAc,CAAC;aAClD;SACF;QACD;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,2BAA2B;YACxC,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,yBAAyB,EAAE;oBACnE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;iBAC7E;gBACD,QAAQ,EAAE,EAAE;aACb;SACF;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,iDAAiD;YAC9D,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;iBACrE;gBACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;aACrB;SACF;QACD;YACE,IAAI,EAAE,yBAAyB;YAC/B,WAAW,EAAE,gGAAgG;YAC7G,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;oBACtD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;oBACpE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;oBACjF,KAAK,EAAE;wBACL,IAAI,EAAE,OAAO;wBACb,WAAW,EAAE,gCAAgC;wBAC7C,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,UAAU,EAAE;gCACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE;gCAClD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;gCAC5D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;gCAChE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;6BAC5E;4BACD,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;yBAC7B;qBACF;oBACD,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;iBAC7F;gBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,OAAO,CAAC;aAC3D;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,yBAAyB;CAC/E,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAwB,EACxB,IAAY,EACZ,IAAyB;IAEzB,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEhD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,gBAAgB,EAAE,CAAC;YACnB,YAAY,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,CAAC;YACjF,IAAI,CAAC,IAAI,CAAC,WAAW;gBAAE,MAAM,IAAI,eAAe,CAAC,yBAAyB,EAAE,iBAAiB,CAAC,CAAC;YAC/F,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC5D,MAAM,IAAI,eAAe,CAAC,0CAA0C,EAAE,iBAAiB,CAAC,CAAC;YAC3F,CAAC;YAED,MAAM,SAAS,GAAwB;gBACrC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC;gBACzC,MAAM,EAAE,IAAI;aACb,CAAC;YAEF,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;YACzE,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,KAAK,KAAK,CAAC;YACnD,MAAM,WAAW,GAAU,EAAE,CAAC;YAE9B,IAAI,QAAQ,EAAE,CAAC;gBACb,gCAAgC;gBAChC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,kBAAkB,EAAE;oBAC5D,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,SAAS;oBAC3B,IAAI,EAAE,QAAQ;oBACd,SAAS,EAAE,MAAM;oBACjB,eAAe,EAAE,IAAI;oBACrB,MAAM,EAAE,IAAI;oBACZ,WAAW,EAAE,yCAAyC,IAAI,CAAC,IAAI,EAAE;oBACjE,SAAS,EAAE,gBAAgB,UAAU,EAAE;iBACxC,CAAC,CAAC;gBACH,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAE1B,iCAAiC;gBACjC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,kBAAkB,EAAE;oBAC7D,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,UAAU;oBAC5B,IAAI,EAAE,QAAQ;oBACd,SAAS,EAAE,OAAO;oBAClB,eAAe,EAAE,IAAI;oBACrB,MAAM,EAAE,IAAI;oBACZ,WAAW,EAAE,0CAA0C,IAAI,CAAC,IAAI,EAAE;oBAClE,SAAS,EAAE,gBAAgB,UAAU,EAAE;iBACxC,CAAC,CAAC;gBACH,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,kBAAkB;gBAC3B,KAAK,EAAE,WAAW;gBAClB,YAAY,EAAE,WAAW,CAAC,MAAM;gBAChC,IAAI,EAAE,WAAW;aAClB,CAAC;QACJ,CAAC;QAED,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;gBAAE,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACnE,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAE7D,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;gBACrC,KAAK,EAAE,cAAc;gBACrB,KAAK;gBACL,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;gBACvB,MAAM,EAAE,4DAA4D;aACrE,CAAC,CAAC;YACH,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACrD,CAAC;QAED,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,eAAe,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAC;YAErF,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAClE,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAExC,qBAAqB;YACrB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;gBACxC,KAAK,EAAE,kBAAkB;gBACzB,KAAK,EAAE,6BAA6B,UAAU,EAAE;gBAChD,KAAK,EAAE,EAAE;gBACT,MAAM,EAAE,+CAA+C;aACxD,CAAC,CAAC;YAEH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QACpE,CAAC;QAED,KAAK,yBAAyB,CAAC,CAAC,CAAC;YAC/B,gBAAgB,EAAE,CAAC;YACnB,YAAY,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,CAAC;YACjF,IAAI,CAAC,IAAI,CAAC,WAAW;gBAAE,MAAM,IAAI,eAAe,CAAC,yBAAyB,EAAE,iBAAiB,CAAC,CAAC;YAC/F,IAAI,CAAC,IAAI,CAAC,YAAY;gBAAE,MAAM,IAAI,eAAe,CAAC,0BAA0B,EAAE,iBAAiB,CAAC,CAAC;YACjG,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9C,MAAM,IAAI,eAAe,CAAC,wBAAwB,EAAE,iBAAiB,CAAC,CAAC;YACzE,CAAC;YAED,MAAM,YAAY,GAAwB;gBACxC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,KAAK,EAAE,IAAI,CAAC,YAAY;gBACxB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;gBACjC,MAAM,EAAE,IAAI;aACb,CAAC;YACF,IAAI,IAAI,CAAC,kBAAkB;gBAAE,YAAY,CAAC,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,CAAC;YAEvF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,yBAAyB,EAAE,YAAY,CAAC,CAAC;YAClF,OAAO,EAAE,OAAO,EAAE,0BAA0B,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnE,CAAC;QAED;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/tools/cmdb-reconciliation.d.ts

@@ -0,0 +1,112 @@
+/**
+ * CMDB Reconciliation tools — find duplicates, orphans, stale CIs, and reconcile.
+ * Read tools: Tier 0. Reconcile action: Tier 2 (CMDB_WRITE_ENABLED=true).
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getCmdbReconciliationToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            ci_class: {
+                type: string;
+                description: string;
+            };
+            match_fields: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            days_threshold?: undefined;
+            action?: undefined;
+            targets?: undefined;
+            dry_run?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            ci_class: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            match_fields?: undefined;
+            days_threshold?: undefined;
+            action?: undefined;
+            targets?: undefined;
+            dry_run?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            ci_class: {
+                type: string;
+                description: string;
+            };
+            days_threshold: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            match_fields?: undefined;
+            action?: undefined;
+            targets?: undefined;
+            dry_run?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            targets: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            dry_run: {
+                type: string;
+                description: string;
+            };
+            ci_class?: undefined;
+            match_fields?: undefined;
+            limit?: undefined;
+            days_threshold?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare function executeCmdbReconciliationToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=cmdb-reconciliation.d.ts.map

package/dist/tools/cmdb-reconciliation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmdb-reconciliation.d.ts","sourceRoot":"","sources":["../../src/tools/cmdb-reconciliation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,wBAAgB,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkEnD;AAMD,wBAAsB,iCAAiC,CACrD,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAyNd"}

package/dist/tools/cmdb-reconciliation.js

@@ -0,0 +1,267 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireCmdbWrite } from '../utils/permissions.js';
+export function getCmdbReconciliationToolDefinitions() {
+    return [
+        {
+            name: 'cmdb_find_duplicates',
+            description: 'Find duplicate CIs by matching on specified fields (in-memory grouping)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    ci_class: { type: 'string', description: 'CI class table (default cmdb_ci)' },
+                    match_fields: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Fields to match on for duplicate detection (default: name, serial_number, ip_address)',
+                    },
+                    limit: { type: 'number', description: 'Max CIs to scan (default 100)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'cmdb_find_orphans',
+            description: 'Find CIs with no relationships in cmdb_rel_ci',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    ci_class: { type: 'string', description: 'CI class table (default cmdb_ci)' },
+                    limit: { type: 'number', description: 'Max orphan CIs to return (default 50)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'cmdb_find_stale',
+            description: 'Find CIs not updated within a given number of days that are still operational',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    ci_class: { type: 'string', description: 'CI class table (default cmdb_ci)' },
+                    days_threshold: { type: 'number', description: 'Number of days since last update to consider stale (default 90)' },
+                    limit: { type: 'number', description: 'Max stale CIs to return (default 50)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'cmdb_reconcile',
+            description: 'Act on duplicate, stale, or orphan CIs — merge, retire, or remove (requires CMDB_WRITE_ENABLED). Supports dry_run mode.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    action: {
+                        type: 'string',
+                        enum: ['merge_duplicates', 'retire_stale', 'remove_orphans'],
+                        description: 'Reconciliation action to perform',
+                    },
+                    targets: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Array of CI sys_ids to act on',
+                    },
+                    dry_run: { type: 'boolean', description: 'Preview changes without applying (default true)' },
+                },
+                required: ['action', 'targets'],
+            },
+        },
+    ];
+}
+const CMDB_RECON_TOOL_NAMES = new Set([
+    'cmdb_find_duplicates', 'cmdb_find_orphans', 'cmdb_find_stale', 'cmdb_reconcile',
+]);
+export async function executeCmdbReconciliationToolCall(client, name, args) {
+    if (!CMDB_RECON_TOOL_NAMES.has(name))
+        return null;
+    switch (name) {
+        case 'cmdb_find_duplicates': {
+            const ciClass = args.ci_class || 'cmdb_ci';
+            const matchFields = args.match_fields && Array.isArray(args.match_fields) && args.match_fields.length > 0
+                ? args.match_fields
+                : ['name', 'serial_number', 'ip_address'];
+            const limit = args.limit || 100;
+            const fields = ['sys_id', 'name', 'sys_class_name', ...matchFields].filter((v, i, a) => a.indexOf(v) === i);
+            const resp = await client.queryRecords({
+                table: ciClass,
+                query: 'active=true',
+                limit,
+                fields: fields.join(','),
+            });
+            // Group CIs by composite key of match fields
+            const groups = new Map();
+            for (const record of resp.records) {
+                const key = matchFields
+                    .map((f) => String(record[f] ?? '').toLowerCase().trim())
+                    .join('||');
+                // Skip records where all match fields are empty
+                const allEmpty = matchFields.every((f) => !record[f] || String(record[f]).trim() === '');
+                if (allEmpty)
+                    continue;
+                if (!groups.has(key))
+                    groups.set(key, []);
+                groups.get(key).push(record);
+            }
+            // Filter to groups with more than one CI (actual duplicates)
+            const duplicates = [];
+            for (const [key, records] of groups) {
+                if (records.length > 1) {
+                    duplicates.push({ match_key: key, count: records.length, records });
+                }
+            }
+            return {
+                ci_class: ciClass,
+                match_fields: matchFields,
+                scanned: resp.records.length,
+                duplicate_groups: duplicates.length,
+                duplicates,
+            };
+        }
+        case 'cmdb_find_orphans': {
+            const ciClass = args.ci_class || 'cmdb_ci';
+            const limit = args.limit || 50;
+            const ciResp = await client.queryRecords({
+                table: ciClass,
+                query: 'active=true',
+                limit,
+                fields: 'sys_id,name,sys_class_name,operational_status',
+            });
+            const orphans = [];
+            for (const ci of ciResp.records) {
+                const sysId = String(ci.sys_id);
+                // Check for any relationship (as parent or child)
+                const relResp = await client.queryRecords({
+                    table: 'cmdb_rel_ci',
+                    query: `parent=${sysId}^ORchild=${sysId}`,
+                    limit: 1,
+                    fields: 'sys_id',
+                });
+                if (relResp.count === 0) {
+                    orphans.push(ci);
+                }
+            }
+            return {
+                ci_class: ciClass,
+                scanned: ciResp.records.length,
+                orphan_count: orphans.length,
+                orphans,
+            };
+        }
+        case 'cmdb_find_stale': {
+            const ciClass = args.ci_class || 'cmdb_ci';
+            const daysThreshold = args.days_threshold || 90;
+            const limit = args.limit || 50;
+            const query = `sys_updated_on<javascript:gs.daysAgo(${daysThreshold})^operational_status=1^active=true`;
+            const resp = await client.queryRecords({
+                table: ciClass,
+                query,
+                limit,
+                fields: 'sys_id,name,sys_class_name,operational_status,sys_updated_on,discovery_source',
+            });
+            return {
+                ci_class: ciClass,
+                days_threshold: daysThreshold,
+                stale_count: resp.count,
+                stale_cis: resp.records,
+            };
+        }
+        case 'cmdb_reconcile': {
+            requireCmdbWrite();
+            if (!args.action)
+                throw new ServiceNowError('action is required', 'INVALID_REQUEST');
+            if (!args.targets || !Array.isArray(args.targets) || args.targets.length === 0) {
+                throw new ServiceNowError('targets must be a non-empty array of sys_ids', 'INVALID_REQUEST');
+            }
+            const validActions = ['merge_duplicates', 'retire_stale', 'remove_orphans'];
+            if (!validActions.includes(args.action)) {
+                throw new ServiceNowError(`Invalid action: "${args.action}". Must be one of: ${validActions.join(', ')}`, 'INVALID_REQUEST');
+            }
+            const dryRun = args.dry_run !== false;
+            const results = [];
+            switch (args.action) {
+                case 'merge_duplicates': {
+                    // First target is the survivor; remaining are merged into it
+                    const [survivorId, ...duplicateIds] = args.targets;
+                    if (duplicateIds.length === 0) {
+                        throw new ServiceNowError('merge_duplicates requires at least 2 targets (first is survivor)', 'INVALID_REQUEST');
+                    }
+                    if (dryRun) {
+                        results.push({ sys_id: survivorId, action: 'keep', status: 'dry_run', detail: 'Would be kept as the survivor CI' });
+                        for (const dupId of duplicateIds) {
+                            results.push({ sys_id: dupId, action: 'retire', status: 'dry_run', detail: 'Would be retired and relationships moved to survivor' });
+                        }
+                    }
+                    else {
+                        results.push({ sys_id: survivorId, action: 'keep', status: 'completed', detail: 'Kept as survivor CI' });
+                        for (const dupId of duplicateIds) {
+                            // Move relationships from duplicate to survivor
+                            const parentRels = await client.queryRecords({
+                                table: 'cmdb_rel_ci',
+                                query: `parent=${dupId}`,
+                                limit: 200,
+                                fields: 'sys_id,child,type',
+                            });
+                            for (const rel of parentRels.records) {
+                                await client.updateRecord('cmdb_rel_ci', String(rel.sys_id), { parent: survivorId });
+                            }
+                            const childRels = await client.queryRecords({
+                                table: 'cmdb_rel_ci',
+                                query: `child=${dupId}`,
+                                limit: 200,
+                                fields: 'sys_id,parent,type',
+                            });
+                            for (const rel of childRels.records) {
+                                await client.updateRecord('cmdb_rel_ci', String(rel.sys_id), { child: survivorId });
+                            }
+                            // Retire the duplicate
+                            await client.updateRecord('cmdb_ci', dupId, {
+                                operational_status: 6, // retired
+                                install_status: 7, // retired
+                            });
+                            results.push({ sys_id: dupId, action: 'retire', status: 'completed', detail: `Retired; ${parentRels.count + childRels.count} relationships moved to survivor` });
+                        }
+                    }
+                    break;
+                }
+                case 'retire_stale': {
+                    for (const sysId of args.targets) {
+                        if (dryRun) {
+                            results.push({ sys_id: sysId, action: 'retire', status: 'dry_run', detail: 'Would set operational_status=6 (retired)' });
+                        }
+                        else {
+                            await client.updateRecord('cmdb_ci', sysId, {
+                                operational_status: 6,
+                                install_status: 7,
+                            });
+                            results.push({ sys_id: sysId, action: 'retire', status: 'completed', detail: 'Set operational_status=6 (retired)' });
+                        }
+                    }
+                    break;
+                }
+                case 'remove_orphans': {
+                    for (const sysId of args.targets) {
+                        if (dryRun) {
+                            results.push({ sys_id: sysId, action: 'retire', status: 'dry_run', detail: 'Would retire orphan CI (operational_status=6)' });
+                        }
+                        else {
+                            await client.updateRecord('cmdb_ci', sysId, {
+                                operational_status: 6,
+                                install_status: 7,
+                            });
+                            results.push({ sys_id: sysId, action: 'retire', status: 'completed', detail: 'Orphan CI retired (operational_status=6)' });
+                        }
+                    }
+                    break;
+                }
+            }
+            return {
+                action: args.action,
+                dry_run: dryRun,
+                target_count: args.targets.length,
+                results,
+            };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=cmdb-reconciliation.js.map

package/dist/tools/cmdb-reconciliation.js.map

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

package/dist/tools/discovery.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Dynamic Schema Discovery tool — reads table schema at runtime and generates
+ * ad-hoc CRUD tools for any ServiceNow table.
+ *
+ * Tools:
+ *   discover_table — Discover a table's schema and register dynamic CRUD tools
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getDiscoveryToolDefinitions(): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            table: {
+                type: string;
+                description: string;
+            };
+            operations: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+            };
+        };
+        required: string[];
+    };
+}[];
+export declare function executeDiscoveryToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+/** Execute a dynamically discovered tool. */
+export declare function executeDynamicToolCall(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;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAKhE,wBAAgB,2BAA2B;;;;;;;;;;;;;;;;;;;;;IAuB1C;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,CA2Fd;AAED,6CAA6C;AAC7C,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAwDd"}