@tedorigawa001/servicenow-mcp 1.0.2

package/dist/tools/csm.js

@@ -0,0 +1,256 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireWrite } from '../utils/permissions.js';
+import { PRIORITY } from './schema-helpers.js';
+export function getCsmToolDefinitions() {
+    return [
+        {
+            name: 'create_csm_case',
+            description: 'Create a new Customer Service case (requires WRITE_ENABLED=true)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    short_description: { type: 'string', description: 'Brief summary of the customer issue' },
+                    account: { type: 'string', description: 'Account name or sys_id' },
+                    contact: { type: 'string', description: 'Contact name or sys_id (the person raising the case)' },
+                    category: { type: 'string', description: 'Case category (e.g., "Product", "Billing", "Technical")' },
+                    subcategory: { type: 'string', description: 'Case subcategory' },
+                    priority: PRIORITY,
+                    description: { type: 'string', description: 'Detailed description of the customer issue' },
+                    product: { type: 'string', description: 'Product or service sys_id related to the case' },
+                    assignment_group: { type: 'string', description: 'CSM assignment group' },
+                },
+                required: ['short_description'],
+            },
+        },
+        {
+            name: 'get_csm_case',
+            description: 'Get full details of a CSM case by number (e.g. CS0001234) or sys_id',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    number_or_sysid: { type: 'string', description: 'Case number (CS...) or sys_id' },
+                },
+                required: ['number_or_sysid'],
+            },
+        },
+        {
+            name: 'update_csm_case',
+            description: 'Update fields on an existing CSM case (requires WRITE_ENABLED=true)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'System ID of the CSM case' },
+                    fields: { type: 'object', description: 'Key-value pairs of fields to update' },
+                },
+                required: ['sys_id', 'fields'],
+            },
+        },
+        {
+            name: 'list_csm_cases',
+            description: 'List CSM cases with optional filters (account, contact, state, priority)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    account: { type: 'string', description: 'Filter by account name or sys_id' },
+                    contact: { type: 'string', description: 'Filter by contact name or sys_id' },
+                    state: { type: 'string', description: 'Filter by state (open, resolved, closed)' },
+                    priority: { ...PRIORITY, description: 'Filter by priority. ' + PRIORITY.description },
+                    limit: { type: 'number', description: 'Max records to return (default 25)' },
+                    query: { type: 'string', description: 'Additional encoded query' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'close_csm_case',
+            description: 'Close a CSM case with resolution details (requires WRITE_ENABLED=true)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'System ID of the CSM case' },
+                    resolution_code: { type: 'string', description: 'How the case was resolved' },
+                    resolution_notes: { type: 'string', description: 'Detailed resolution notes' },
+                },
+                required: ['sys_id', 'resolution_notes'],
+            },
+        },
+        {
+            name: 'get_csm_account',
+            description: 'Get details of a customer account including contacts and open cases count',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name_or_sysid: { type: 'string', description: 'Account name or sys_id' },
+                },
+                required: ['name_or_sysid'],
+            },
+        },
+        {
+            name: 'list_csm_accounts',
+            description: 'List customer accounts with optional search filter',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Search accounts by name' },
+                    active: { type: 'boolean', description: 'Filter to active accounts only (default true)' },
+                    limit: { type: 'number', description: 'Max records to return (default 50)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'get_csm_contact',
+            description: 'Get details of a customer contact (name, account, phone, email)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name_or_sysid: { type: 'string', description: 'Contact name, email, or sys_id' },
+                },
+                required: ['name_or_sysid'],
+            },
+        },
+        {
+            name: 'list_csm_contacts',
+            description: 'List contacts for an account or search across all contacts',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    account_sysid: { type: 'string', description: 'Filter contacts by account sys_id' },
+                    query: { type: 'string', description: 'Search by name or email' },
+                    limit: { type: 'number', description: 'Max records to return (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'get_csm_case_sla',
+            description: 'Get SLA details and remaining time for a CSM case',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    case_sysid: { type: 'string', description: 'sys_id of the CSM case' },
+                },
+                required: ['case_sysid'],
+            },
+        },
+        {
+            name: 'list_csm_products',
+            description: 'List products and services available in the CSM catalog',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Search products by name' },
+                    limit: { type: 'number', description: 'Max records to return (default 50)' },
+                },
+                required: [],
+            },
+        },
+    ];
+}
+export async function executeCsmToolCall(client, name, args) {
+    switch (name) {
+        case 'create_csm_case': {
+            requireWrite();
+            if (!args.short_description)
+                throw new ServiceNowError('short_description is required', 'INVALID_REQUEST');
+            const result = await client.createRecord('sn_customerservice_case', args);
+            return { ...result, summary: `Created CSM case ${result.number || result.sys_id}` };
+        }
+        case 'get_csm_case': {
+            if (!args.number_or_sysid)
+                throw new ServiceNowError('number_or_sysid is required', 'INVALID_REQUEST');
+            if (/^[0-9a-f]{32}$/i.test(args.number_or_sysid)) {
+                return await client.getRecord('sn_customerservice_case', args.number_or_sysid);
+            }
+            const resp = await client.queryRecords({ table: 'sn_customerservice_case', query: `number=${args.number_or_sysid}`, limit: 1 });
+            if (resp.count === 0)
+                throw new ServiceNowError(`CSM case not found: ${args.number_or_sysid}`, 'NOT_FOUND');
+            return resp.records[0];
+        }
+        case 'update_csm_case': {
+            requireWrite();
+            if (!args.sys_id || !args.fields)
+                throw new ServiceNowError('sys_id and fields are required', 'INVALID_REQUEST');
+            const result = await client.updateRecord('sn_customerservice_case', args.sys_id, args.fields);
+            return { ...result, summary: `Updated CSM case ${args.sys_id}` };
+        }
+        case 'list_csm_cases': {
+            const parts = [];
+            if (args.account)
+                parts.push(`account.name=${args.account}`);
+            if (args.contact)
+                parts.push(`contact.name=${args.contact}`);
+            if (args.state)
+                parts.push(`state=${args.state}`);
+            if (args.priority)
+                parts.push(`priority=${args.priority}`);
+            if (args.query)
+                parts.push(args.query);
+            const resp = await client.queryRecords({ table: 'sn_customerservice_case', query: parts.join('^') || '', limit: args.limit ?? 25 });
+            return resp;
+        }
+        case 'close_csm_case': {
+            requireWrite();
+            if (!args.sys_id || !args.resolution_notes)
+                throw new ServiceNowError('sys_id and resolution_notes are required', 'INVALID_REQUEST');
+            const result = await client.updateRecord('sn_customerservice_case', args.sys_id, {
+                state: 'closed',
+                close_notes: args.resolution_notes,
+                ...(args.resolution_code ? { close_code: args.resolution_code } : {}),
+            });
+            return { ...result, summary: `Closed CSM case ${args.sys_id}` };
+        }
+        case 'get_csm_account': {
+            if (!args.name_or_sysid)
+                throw new ServiceNowError('name_or_sysid is required', 'INVALID_REQUEST');
+            if (/^[0-9a-f]{32}$/i.test(args.name_or_sysid)) {
+                return await client.getRecord('customer_account', args.name_or_sysid);
+            }
+            const resp = await client.queryRecords({ table: 'customer_account', query: `name=${args.name_or_sysid}`, limit: 1 });
+            if (resp.count === 0)
+                throw new ServiceNowError(`Account not found: ${args.name_or_sysid}`, 'NOT_FOUND');
+            return resp.records[0];
+        }
+        case 'list_csm_accounts': {
+            const active = args.active !== false ? 'active=true' : '';
+            const q = args.query ? `nameCONTAINS${args.query}` : '';
+            const query = [active, q].filter(Boolean).join('^');
+            return await client.queryRecords({ table: 'customer_account', query, limit: args.limit ?? 50 });
+        }
+        case 'get_csm_contact': {
+            if (!args.name_or_sysid)
+                throw new ServiceNowError('name_or_sysid is required', 'INVALID_REQUEST');
+            if (/^[0-9a-f]{32}$/i.test(args.name_or_sysid)) {
+                return await client.getRecord('customer_contact', args.name_or_sysid);
+            }
+            const resp = await client.queryRecords({
+                table: 'customer_contact',
+                query: `nameCONTAINS${args.name_or_sysid}^ORemail=${args.name_or_sysid}`,
+                limit: 1,
+            });
+            if (resp.count === 0)
+                throw new ServiceNowError(`Contact not found: ${args.name_or_sysid}`, 'NOT_FOUND');
+            return resp.records[0];
+        }
+        case 'list_csm_contacts': {
+            const parts = [];
+            if (args.account_sysid)
+                parts.push(`account=${args.account_sysid}`);
+            if (args.query)
+                parts.push(`nameCONTAINS${args.query}^ORemail=${args.query}`);
+            return await client.queryRecords({ table: 'customer_contact', query: parts.join('^') || '', limit: args.limit ?? 25 });
+        }
+        case 'get_csm_case_sla': {
+            if (!args.case_sysid)
+                throw new ServiceNowError('case_sysid is required', 'INVALID_REQUEST');
+            return await client.queryRecords({ table: 'task_sla', query: `task=${args.case_sysid}`, limit: 10 });
+        }
+        case 'list_csm_products': {
+            const q = args.query ? `nameCONTAINS${args.query}` : '';
+            return await client.queryRecords({ table: 'cmdb_ci_service', query: q, limit: args.limit ?? 50 });
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=csm.js.map

package/dist/tools/csm.js.map

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

package/dist/tools/deployment.d.ts

@@ -0,0 +1,366 @@
+/**
+ * Deployment & Artifact lifecycle tools — artifact validation, push/pull,
+ * deployment tracking, rollback, and solution packaging.
+ *
+ * NOTE: Does NOT duplicate existing devops.ts (pipelines, deployments) or
+ * updateset.ts (update set CRUD). These tools add artifact-level management
+ * and deployment orchestration.
+ *
+ * ServiceNow tables: sys_update_xml, sys_remote_update_set, sys_app,
+ *   sys_store_app, sn_devops_artifact
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getDeploymentToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                description: string;
+            };
+            scope: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+            };
+            table?: undefined;
+            sys_id?: undefined;
+            new_name?: undefined;
+            target_scope?: undefined;
+            update_set_sys_id?: undefined;
+            app_sys_id?: undefined;
+            reason?: undefined;
+            days?: undefined;
+            description?: undefined;
+            update_sets?: undefined;
+            script?: undefined;
+            data?: undefined;
+            required_fields?: undefined;
+            days_stale?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            table: {
+                type: string;
+                description: string;
+            };
+            sys_id: {
+                type: string;
+                description: string;
+            };
+            name?: undefined;
+            type?: undefined;
+            scope?: undefined;
+            limit?: undefined;
+            new_name?: undefined;
+            target_scope?: undefined;
+            update_set_sys_id?: undefined;
+            app_sys_id?: undefined;
+            reason?: undefined;
+            days?: undefined;
+            description?: undefined;
+            update_sets?: undefined;
+            script?: undefined;
+            data?: undefined;
+            required_fields?: undefined;
+            days_stale?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            table: {
+                type: string;
+                description: string;
+            };
+            sys_id: {
+                type: string;
+                description: string;
+            };
+            new_name: {
+                type: string;
+                description: string;
+            };
+            target_scope: {
+                type: string;
+                description: string;
+            };
+            name?: undefined;
+            type?: undefined;
+            scope?: undefined;
+            limit?: undefined;
+            update_set_sys_id?: undefined;
+            app_sys_id?: undefined;
+            reason?: undefined;
+            days?: undefined;
+            description?: undefined;
+            update_sets?: undefined;
+            script?: undefined;
+            data?: undefined;
+            required_fields?: undefined;
+            days_stale?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            update_set_sys_id: {
+                type: string;
+                description: string;
+            };
+            app_sys_id: {
+                type: string;
+                description: string;
+            };
+            name?: undefined;
+            type?: undefined;
+            scope?: undefined;
+            limit?: undefined;
+            table?: undefined;
+            sys_id?: undefined;
+            new_name?: undefined;
+            target_scope?: undefined;
+            reason?: undefined;
+            days?: undefined;
+            description?: undefined;
+            update_sets?: undefined;
+            script?: undefined;
+            data?: undefined;
+            required_fields?: undefined;
+            days_stale?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            update_set_sys_id: {
+                type: string;
+                description: string;
+            };
+            reason: {
+                type: string;
+                description: string;
+            };
+            name?: undefined;
+            type?: undefined;
+            scope?: undefined;
+            limit?: undefined;
+            table?: undefined;
+            sys_id?: undefined;
+            new_name?: undefined;
+            target_scope?: undefined;
+            app_sys_id?: undefined;
+            days?: undefined;
+            description?: undefined;
+            update_sets?: undefined;
+            script?: undefined;
+            data?: undefined;
+            required_fields?: undefined;
+            days_stale?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            days: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+            };
+            name?: undefined;
+            type?: undefined;
+            scope?: undefined;
+            table?: undefined;
+            sys_id?: undefined;
+            new_name?: undefined;
+            target_scope?: undefined;
+            update_set_sys_id?: undefined;
+            app_sys_id?: undefined;
+            reason?: undefined;
+            description?: undefined;
+            update_sets?: undefined;
+            script?: undefined;
+            data?: undefined;
+            required_fields?: undefined;
+            days_stale?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+            };
+            update_sets: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            type?: undefined;
+            scope?: undefined;
+            limit?: undefined;
+            table?: undefined;
+            sys_id?: undefined;
+            new_name?: undefined;
+            target_scope?: undefined;
+            update_set_sys_id?: undefined;
+            app_sys_id?: undefined;
+            reason?: undefined;
+            days?: undefined;
+            script?: undefined;
+            data?: undefined;
+            required_fields?: undefined;
+            days_stale?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            script: {
+                type: string;
+                description: string;
+            };
+            scope: {
+                type: string;
+                description: string;
+            };
+            name?: undefined;
+            type?: undefined;
+            limit?: undefined;
+            table?: undefined;
+            sys_id?: undefined;
+            new_name?: undefined;
+            target_scope?: undefined;
+            update_set_sys_id?: undefined;
+            app_sys_id?: undefined;
+            reason?: undefined;
+            days?: undefined;
+            description?: undefined;
+            update_sets?: undefined;
+            data?: undefined;
+            required_fields?: undefined;
+            days_stale?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            table: {
+                type: string;
+                description: string;
+            };
+            data: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            name?: undefined;
+            type?: undefined;
+            scope?: undefined;
+            limit?: undefined;
+            sys_id?: undefined;
+            new_name?: undefined;
+            target_scope?: undefined;
+            update_set_sys_id?: undefined;
+            app_sys_id?: undefined;
+            reason?: undefined;
+            days?: undefined;
+            description?: undefined;
+            update_sets?: undefined;
+            script?: undefined;
+            required_fields?: undefined;
+            days_stale?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            table: {
+                type: string;
+                description: string;
+            };
+            required_fields: {
+                type: string;
+                description: string;
+            };
+            days_stale: {
+                type: string;
+                description: string;
+            };
+            name?: undefined;
+            type?: undefined;
+            scope?: undefined;
+            limit?: undefined;
+            sys_id?: undefined;
+            new_name?: undefined;
+            target_scope?: undefined;
+            update_set_sys_id?: undefined;
+            app_sys_id?: undefined;
+            reason?: undefined;
+            days?: undefined;
+            description?: undefined;
+            update_sets?: undefined;
+            script?: undefined;
+            data?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare function executeDeploymentToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=deployment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deployment.d.ts","sourceRoot":"","sources":["../../src/tools/deployment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,wBAAgB,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAqD3C;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAkHd"}