nowaikit 4.11.0 → 4.12.0

package/dist/tools/sn-parity.d.ts

@@ -0,0 +1,239 @@
+/**
+ * Parity tools closing the remaining gaps vs ServiceNow's first-party MCP servers
+ * (HRSD, CSM, Quickstart summarization, Now Assist skills) plus a server health check.
+ *
+ * Two kinds of tools:
+ *  - Pure REST (work on any instance): list_csm_case_tasks, advance_hr_case,
+ *    search_hr_knowledge, mcp_health_check.
+ *  - Now Assist skill-backed (light up when Now Assist is licensed; otherwise they still
+ *    return the assembled record context so the connected LLM can do the reasoning — this
+ *    is deliberately better than ServiceNow, which hard-requires Now Assist): summarize_record,
+ *    get_case_sentiment, generate_case_activity_response, generate_csm_resolution_notes,
+ *    check_hr_eligibility.
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getSnParityToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            case: {
+                type: string;
+                description: string;
+            };
+            active: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            work_notes?: undefined;
+            query?: undefined;
+            kb?: undefined;
+            table?: undefined;
+            record?: undefined;
+            instruction?: undefined;
+            user?: undefined;
+            hr_service?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            case: {
+                type: string;
+                description: string;
+            };
+            state: {
+                type: string;
+                description: string;
+            };
+            work_notes: {
+                type: string;
+                description: string;
+            };
+            active?: undefined;
+            limit?: undefined;
+            query?: undefined;
+            kb?: undefined;
+            table?: undefined;
+            record?: undefined;
+            instruction?: undefined;
+            user?: undefined;
+            hr_service?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            kb: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            case?: undefined;
+            active?: undefined;
+            state?: undefined;
+            work_notes?: undefined;
+            table?: undefined;
+            record?: undefined;
+            instruction?: undefined;
+            user?: undefined;
+            hr_service?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            case?: undefined;
+            active?: undefined;
+            limit?: undefined;
+            state?: undefined;
+            work_notes?: undefined;
+            query?: undefined;
+            kb?: undefined;
+            table?: undefined;
+            record?: undefined;
+            instruction?: undefined;
+            user?: undefined;
+            hr_service?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            table: {
+                type: string;
+                description: string;
+            };
+            record: {
+                type: string;
+                description: string;
+            };
+            case?: undefined;
+            active?: undefined;
+            limit?: undefined;
+            state?: undefined;
+            work_notes?: undefined;
+            query?: undefined;
+            kb?: undefined;
+            instruction?: undefined;
+            user?: undefined;
+            hr_service?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            case: {
+                type: string;
+                description: string;
+            };
+            table: {
+                type: string;
+                description: string;
+            };
+            active?: undefined;
+            limit?: undefined;
+            state?: undefined;
+            work_notes?: undefined;
+            query?: undefined;
+            kb?: undefined;
+            record?: undefined;
+            instruction?: undefined;
+            user?: undefined;
+            hr_service?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            case: {
+                type: string;
+                description: string;
+            };
+            table: {
+                type: string;
+                description: string;
+            };
+            instruction: {
+                type: string;
+                description: string;
+            };
+            active?: undefined;
+            limit?: undefined;
+            state?: undefined;
+            work_notes?: undefined;
+            query?: undefined;
+            kb?: undefined;
+            record?: undefined;
+            user?: undefined;
+            hr_service?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            user: {
+                type: string;
+                description: string;
+            };
+            hr_service: {
+                type: string;
+                description: string;
+            };
+            case?: undefined;
+            active?: undefined;
+            limit?: undefined;
+            state?: undefined;
+            work_notes?: undefined;
+            query?: undefined;
+            kb?: undefined;
+            table?: undefined;
+            record?: undefined;
+            instruction?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare function executeSnParityToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=sn-parity.d.ts.map

package/dist/tools/sn-parity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sn-parity.d.ts","sourceRoot":"","sources":["../../src/tools/sn-parity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAoChE,wBAAgB,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4GzC;AAED,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAkFd"}

package/dist/tools/sn-parity.js

@@ -0,0 +1,236 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireWrite } from '../utils/permissions.js';
+/** Best-effort Now Assist skill invocation by (partial) name. Returns null if unavailable. */
+async function tryInvokeSkill(client, skillName, input) {
+    try {
+        const found = await client.queryRecords({ table: 'sn_now_assist_skill', query: `nameCONTAINS${skillName}^active=true`, limit: 1 });
+        if (found.count === 0)
+            return null;
+        const skillId = found.records[0].sys_id;
+        const res = await client.callNowAssist('/api/sn_assist/skill/invoke', { skill: skillId, input });
+        return { skill: found.records[0].name, output: res };
+    }
+    catch {
+        return null;
+    }
+}
+/** Pull a task record + its journal (comments/work notes) for AI context assembly. */
+async function recordContext(client, table, sysId) {
+    const record = await client.getRecord(table, sysId);
+    const journal = await client.queryRecords({
+        table: 'sys_journal_field',
+        query: `element_id=${sysId}^ORDERBYsys_created_on`,
+        fields: 'element,value,sys_created_by,sys_created_on',
+        limit: 100,
+    }).catch(() => ({ records: [] }));
+    return { record, activity: journal.records };
+}
+async function resolveCase(client, table, ref) {
+    if (/^[0-9a-f]{32}$/i.test(ref))
+        return ref;
+    const r = await client.queryRecords({ table, query: `number=${ref}`, limit: 1 });
+    if (r.count === 0)
+        throw new ServiceNowError(`Record not found: ${ref}`, 'NOT_FOUND');
+    return r.records[0].sys_id;
+}
+export function getSnParityToolDefinitions() {
+    return [
+        {
+            name: 'list_csm_case_tasks',
+            description: 'List the tasks on a CSM case (sn_customerservice_task). Parity with ServiceNow CSM "Get Case Tasks"',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    case: { type: 'string', description: 'CSM case number or sys_id' },
+                    active: { type: 'boolean', description: 'Only active tasks' },
+                    limit: { type: 'number', description: 'Max records (default 50)' },
+                },
+                required: ['case'],
+            },
+        },
+        {
+            name: 'advance_hr_case',
+            description: 'Advance an HR case to its next state/stage (sn_hr_core_case). Parity with ServiceNow HRSD "HR Case Advance". Requires WRITE_ENABLED=true',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    case: { type: 'string', description: 'HR case number or sys_id' },
+                    state: { type: 'string', description: 'Target state value (if known); otherwise increments the current state' },
+                    work_notes: { type: 'string', description: 'Optional work note to add on advance' },
+                },
+                required: ['case'],
+            },
+        },
+        {
+            name: 'search_hr_knowledge',
+            description: 'Search HR-scoped knowledge articles (kb_knowledge in HR knowledge bases). Parity with ServiceNow HRSD "HR Knowledge Search"',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Search text' },
+                    kb: { type: 'string', description: 'Optional specific HR knowledge base sys_id' },
+                    limit: { type: 'number', description: 'Max records (default 20)' },
+                },
+                required: ['query'],
+            },
+        },
+        {
+            name: 'mcp_health_check',
+            description: 'Health check: confirm the instance is reachable and the configured credentials resolve to a valid user. Parity with ServiceNow MCP "Health Check"',
+            inputSchema: { type: 'object', properties: {}, required: [] },
+        },
+        {
+            name: 'summarize_record',
+            description: 'Summarize a record (incident/case/etc.) using the Now Assist summarization skill when available, otherwise return the assembled record + activity for the caller to summarize. Parity with ServiceNow Quickstart incident/case summarization',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    table: { type: 'string', description: 'Table (e.g. incident, sn_customerservice_case, sn_hr_core_case)' },
+                    record: { type: 'string', description: 'Record number or sys_id' },
+                },
+                required: ['table', 'record'],
+            },
+        },
+        {
+            name: 'get_case_sentiment',
+            description: 'Assess customer sentiment on a CSM case via the Now Assist sentiment skill when available, else return the case + customer comments for sentiment analysis. Parity with ServiceNow CSM "Sentiment Analysis"',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    case: { type: 'string', description: 'CSM case number or sys_id' },
+                    table: { type: 'string', description: 'Case table (default sn_customerservice_case)' },
+                },
+                required: ['case'],
+            },
+        },
+        {
+            name: 'generate_case_activity_response',
+            description: 'Draft an agent reply for a CSM case activity stream via the Now Assist activity-response skill when available, else return the case context to draft from. Parity with ServiceNow CSM "Activity Response"',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    case: { type: 'string', description: 'CSM case number or sys_id' },
+                    table: { type: 'string', description: 'Case table (default sn_customerservice_case)' },
+                    instruction: { type: 'string', description: 'Optional tone/instruction for the reply' },
+                },
+                required: ['case'],
+            },
+        },
+        {
+            name: 'generate_csm_resolution_notes',
+            description: 'Generate CSM resolution notes via the Now Assist resolution-notes skill when available, else return the case + work notes to summarize. Parity with ServiceNow CSM "Generate Resolution Notes"',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    case: { type: 'string', description: 'CSM case number or sys_id' },
+                    table: { type: 'string', description: 'Case table (default sn_customerservice_case)' },
+                },
+                required: ['case'],
+            },
+        },
+        {
+            name: 'check_hr_eligibility',
+            description: 'Check an employee\'s eligibility for an HR service/policy via the Policy Based HR Case Evaluator skill when available, else return the employee + service context. Parity with ServiceNow HRSD "HR Eligibility Check"',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    user: { type: 'string', description: 'Employee sys_id, user_name, or email' },
+                    hr_service: { type: 'string', description: 'HR service sys_id or name to check eligibility for' },
+                },
+                required: ['user', 'hr_service'],
+            },
+        },
+    ];
+}
+export async function executeSnParityToolCall(client, name, args) {
+    switch (name) {
+        case 'list_csm_case_tasks': {
+            const caseId = await resolveCase(client, 'sn_customerservice_case', args.case);
+            const parts = [`parent=${caseId}`];
+            if (args.active !== undefined)
+                parts.push(`active=${args.active ? 'true' : 'false'}`);
+            return await client.queryRecords({ table: 'sn_customerservice_task', query: parts.join('^'), limit: args.limit ?? 50 });
+        }
+        case 'advance_hr_case': {
+            requireWrite();
+            const caseId = await resolveCase(client, 'sn_hr_core_case', args.case);
+            const payload = {};
+            if (args.state !== undefined) {
+                payload.state = args.state;
+            }
+            else {
+                const cur = await client.getRecord('sn_hr_core_case', caseId);
+                const curState = parseInt(String(cur.state?.value ?? cur.state ?? '1'), 10);
+                payload.state = String(isNaN(curState) ? 1 : curState + 1);
+            }
+            if (args.work_notes)
+                payload.work_notes = args.work_notes;
+            const result = await client.updateRecord('sn_hr_core_case', caseId, payload);
+            return { ...result, summary: `Advanced HR case ${args.case} to state ${payload.state}` };
+        }
+        case 'search_hr_knowledge': {
+            if (!args.query)
+                throw new ServiceNowError('query is required', 'INVALID_REQUEST');
+            const parts = [`workflow_state=published`, `short_descriptionLIKE${args.query}^ORtextLIKE${args.query}`];
+            if (args.kb)
+                parts.push(`kb_knowledge_base=${args.kb}`);
+            else
+                parts.push('kb_knowledge_base.titleLIKEHR^ORkb_knowledge_base.titleLIKEHuman Resources');
+            return await client.queryRecords({
+                table: 'kb_knowledge',
+                query: parts.join('^'),
+                fields: 'number,short_description,kb_knowledge_base,kb_knowledge_base.title,workflow_state,sys_id',
+                limit: args.limit ?? 20,
+            });
+        }
+        case 'mcp_health_check': {
+            try {
+                const user = await client.getCurrentUser();
+                return { ok: true, reachable: true, authenticated: true, user, note: 'Instance reachable and credentials resolve to a valid user.' };
+            }
+            catch (e) {
+                return { ok: false, reachable: true, authenticated: false, error: e instanceof Error ? e.message : String(e), note: 'Instance responded but the credentials did not authenticate. See the auth diagnostic in the error.' };
+            }
+        }
+        case 'summarize_record': {
+            const sysId = await resolveCase(client, args.table, args.record);
+            const ctx = await recordContext(client, args.table, sysId);
+            const skill = await tryInvokeSkill(client, 'summariz', { table: args.table, sys_id: sysId });
+            return { table: args.table, sys_id: sysId, ...ctx, now_assist: skill, note: skill ? 'Now Assist summary included.' : 'Now Assist summarization skill not found; summarize from the returned record + activity.' };
+        }
+        case 'get_case_sentiment': {
+            const table = args.table || 'sn_customerservice_case';
+            const sysId = await resolveCase(client, table, args.case);
+            const ctx = await recordContext(client, table, sysId);
+            const skill = await tryInvokeSkill(client, 'sentiment', { table, sys_id: sysId });
+            return { table, sys_id: sysId, ...ctx, now_assist: skill, note: skill ? 'Now Assist sentiment included.' : 'Now Assist sentiment skill not found; assess sentiment from the returned comments/activity.' };
+        }
+        case 'generate_case_activity_response': {
+            const table = args.table || 'sn_customerservice_case';
+            const sysId = await resolveCase(client, table, args.case);
+            const ctx = await recordContext(client, table, sysId);
+            const skill = await tryInvokeSkill(client, 'activity response', { table, sys_id: sysId, instruction: args.instruction });
+            return { table, sys_id: sysId, ...ctx, instruction: args.instruction, now_assist: skill, note: skill ? 'Now Assist draft included.' : 'Now Assist activity-response skill not found; draft a reply from the returned context.' };
+        }
+        case 'generate_csm_resolution_notes': {
+            const table = args.table || 'sn_customerservice_case';
+            const sysId = await resolveCase(client, table, args.case);
+            const ctx = await recordContext(client, table, sysId);
+            const skill = await tryInvokeSkill(client, 'resolution', { table, sys_id: sysId });
+            return { table, sys_id: sysId, ...ctx, now_assist: skill, note: skill ? 'Now Assist resolution notes included.' : 'Now Assist resolution-notes skill not found; draft resolution notes from the returned work notes/activity.' };
+        }
+        case 'check_hr_eligibility': {
+            const u = await client.queryRecords({ table: 'sys_user', query: `user_name=${args.user}^ORemail=${args.user}^ORsys_id=${args.user}`, limit: 1 });
+            if (u.count === 0)
+                throw new ServiceNowError(`User not found: ${args.user}`, 'NOT_FOUND');
+            const user = u.records[0];
+            const svc = await client.queryRecords({ table: 'sn_hr_core_service', query: `sys_id=${args.hr_service}^ORname=${args.hr_service}`, limit: 1 }).catch(() => ({ records: [], count: 0 }));
+            const service = svc.count ? svc.records[0] : { note: `HR service not resolved: ${args.hr_service}` };
+            const skill = await tryInvokeSkill(client, 'Case Evaluator', { user: user.sys_id, hr_service: args.hr_service });
+            return { user, hr_service: service, now_assist: skill, note: skill ? 'Policy Based HR Case Evaluator result included.' : 'Policy Based HR Case Evaluator skill not found; evaluate eligibility from the employee + HR service context.' };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=sn-parity.js.map

package/dist/tools/sn-parity.js.map

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

package/dist/tools/survey.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Surveys & Assessments (CSAT/experience). Read: Tier 0. Create/send: Tier 1.
+ *
+ * Tables:
+ *   asmt_metric_type                    — survey/assessment definitions
+ *   asmt_assessment_instance            — issued survey/assessment instances
+ *   asmt_assessment_instance_question   — per-question responses/scores
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getSurveyToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                description: string;
+            };
+            fields: {
+                type: string;
+                description: string;
+            };
+            metric_type?: undefined;
+            user?: undefined;
+            trigger_id?: undefined;
+            trigger_table?: undefined;
+            instance?: undefined;
+            limit?: undefined;
+            state?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            metric_type: {
+                type: string;
+                description: string;
+            };
+            user: {
+                type: string;
+                description: string;
+            };
+            trigger_id: {
+                type: string;
+                description: string;
+            };
+            trigger_table: {
+                type: string;
+                description: string;
+            };
+            fields: {
+                type: string;
+                description: string;
+            };
+            name?: undefined;
+            description?: undefined;
+            type?: undefined;
+            instance?: undefined;
+            limit?: undefined;
+            state?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            instance: {
+                type: string;
+                description: string;
+            };
+            metric_type: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            name?: undefined;
+            description?: undefined;
+            type?: undefined;
+            fields?: undefined;
+            user?: undefined;
+            trigger_id?: undefined;
+            trigger_table?: undefined;
+            state?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            state: {
+                type: string;
+                description: string;
+            };
+            user: {
+                type: string;
+                description: string;
+            };
+            metric_type: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            name?: undefined;
+            description?: undefined;
+            type?: undefined;
+            fields?: undefined;
+            trigger_id?: undefined;
+            trigger_table?: undefined;
+            instance?: undefined;
+        };
+        required: never[];
+    };
+})[];
+export declare function executeSurveyToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=survey.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"survey.d.ts","sourceRoot":"","sources":["../../src/tools/survey.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,wBAAgB,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA2DvC;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CA0Cd"}