nowaikit 2.5.1

package/dist/tools/incident.js

@@ -0,0 +1,163 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireWrite } from '../utils/permissions.js';
+export function getIncidentToolDefinitions() {
+    return [
+        {
+            name: 'create_incident',
+            description: 'Create a new incident record (requires WRITE_ENABLED=true)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    short_description: { type: 'string', description: 'Brief description of the issue' },
+                    urgency: { type: 'number', description: '1=High, 2=Medium, 3=Low' },
+                    impact: { type: 'number', description: '1=High, 2=Medium, 3=Low' },
+                    priority: { type: 'number', description: '1=Critical, 2=High, 3=Moderate, 4=Low' },
+                    description: { type: 'string', description: 'Detailed description' },
+                    assignment_group: { type: 'string', description: 'Assignment group name or sys_id' },
+                    caller_id: { type: 'string', description: 'Caller user name or sys_id' },
+                    category: { type: 'string', description: 'Incident category' },
+                    subcategory: { type: 'string', description: 'Incident subcategory' },
+                },
+                required: ['short_description'],
+            },
+        },
+        {
+            name: 'get_incident',
+            description: 'Get full details of an incident by number (e.g. INC0012345) or sys_id',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    number_or_sysid: { type: 'string', description: 'Incident number (INC...) or sys_id' },
+                },
+                required: ['number_or_sysid'],
+            },
+        },
+        {
+            name: 'update_incident',
+            description: 'Update fields on an existing incident (requires WRITE_ENABLED=true)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'System ID of the incident' },
+                    fields: { type: 'object', description: 'Key-value pairs to update (e.g., {"state": "2", "urgency": "1"})' },
+                },
+                required: ['sys_id', 'fields'],
+            },
+        },
+        {
+            name: 'resolve_incident',
+            description: 'Resolve an incident with resolution code and notes (requires WRITE_ENABLED=true)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'System ID of the incident' },
+                    resolution_code: { type: 'string', description: 'Resolution code (e.g., "Solved (Permanently)")' },
+                    resolution_notes: { type: 'string', description: 'Details of how the incident was resolved' },
+                },
+                required: ['sys_id', 'resolution_code', 'resolution_notes'],
+            },
+        },
+        {
+            name: 'close_incident',
+            description: 'Close a resolved incident (requires WRITE_ENABLED=true)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'System ID of the incident' },
+                },
+                required: ['sys_id'],
+            },
+        },
+        {
+            name: 'add_work_note',
+            description: 'Add an internal work note to any ITSM record (requires WRITE_ENABLED=true)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    table: { type: 'string', description: 'Table name (e.g., "incident", "change_request")' },
+                    sys_id: { type: 'string', description: 'System ID of the record' },
+                    note: { type: 'string', description: 'Work note text (internal, not visible to end user)' },
+                },
+                required: ['table', 'sys_id', 'note'],
+            },
+        },
+        {
+            name: 'add_comment',
+            description: 'Add a customer-visible comment to any ITSM record (requires WRITE_ENABLED=true)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    table: { type: 'string', description: 'Table name (e.g., "incident")' },
+                    sys_id: { type: 'string', description: 'System ID of the record' },
+                    comment: { type: 'string', description: 'Comment text (visible to end user/caller)' },
+                },
+                required: ['table', 'sys_id', 'comment'],
+            },
+        },
+    ];
+}
+export async function executeIncidentToolCall(client, name, args) {
+    switch (name) {
+        case 'create_incident': {
+            requireWrite();
+            if (!args.short_description)
+                throw new ServiceNowError('short_description is required', 'INVALID_REQUEST');
+            const result = await client.createRecord('incident', args);
+            return { ...result, summary: `Created incident ${result.number || result.sys_id}` };
+        }
+        case 'get_incident': {
+            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('incident', args.number_or_sysid);
+            }
+            const resp = await client.queryRecords({ table: 'incident', query: `number=${args.number_or_sysid}^ORsys_id=${args.number_or_sysid}`, limit: 1 });
+            if (resp.count === 0)
+                throw new ServiceNowError(`Incident not found: ${args.number_or_sysid}`, 'NOT_FOUND');
+            return resp.records[0];
+        }
+        case 'update_incident': {
+            requireWrite();
+            if (!args.sys_id || !args.fields)
+                throw new ServiceNowError('sys_id and fields are required', 'INVALID_REQUEST');
+            const result = await client.updateRecord('incident', args.sys_id, args.fields);
+            return { ...result, summary: `Updated incident ${args.sys_id}` };
+        }
+        case 'resolve_incident': {
+            requireWrite();
+            if (!args.sys_id || !args.resolution_code || !args.resolution_notes)
+                throw new ServiceNowError('sys_id, resolution_code, and resolution_notes are required', 'INVALID_REQUEST');
+            const result = await client.updateRecord('incident', args.sys_id, {
+                state: '6',
+                close_code: args.resolution_code,
+                close_notes: args.resolution_notes,
+                resolved_at: new Date().toISOString(),
+            });
+            return { ...result, summary: `Resolved incident ${args.sys_id}` };
+        }
+        case 'close_incident': {
+            requireWrite();
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            const result = await client.updateRecord('incident', args.sys_id, { state: '7' });
+            return { ...result, summary: `Closed incident ${args.sys_id}` };
+        }
+        case 'add_work_note': {
+            requireWrite();
+            if (!args.table || !args.sys_id || !args.note)
+                throw new ServiceNowError('table, sys_id, and note are required', 'INVALID_REQUEST');
+            const result = await client.updateRecord(args.table, args.sys_id, { work_notes: args.note });
+            return { ...result, summary: `Added work note to ${args.table} ${args.sys_id}` };
+        }
+        case 'add_comment': {
+            requireWrite();
+            if (!args.table || !args.sys_id || !args.comment)
+                throw new ServiceNowError('table, sys_id, and comment are required', 'INVALID_REQUEST');
+            const result = await client.updateRecord(args.table, args.sys_id, { comments: args.comment });
+            return { ...result, summary: `Added comment to ${args.table} ${args.sys_id}` };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=incident.js.map

package/dist/tools/incident.js.map

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