nowaikit 4.11.0 → 4.12.0

package/dist/tools/approvals-extra.js

@@ -0,0 +1,212 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireWrite } from '../utils/permissions.js';
+const QUOTE_TABLES = ['sn_quote_mgmt_core_quote', 'sn_sales_quote', 'quote'];
+export function getApprovalsExtraToolDefinitions() {
+    return [
+        {
+            name: 'get_quote',
+            description: 'Get a CPQ/sales quote record by number or sys_id (tries known quote tables)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    number: { type: 'string', description: 'Quote number' },
+                    sys_id: { type: 'string', description: 'Quote sys_id' },
+                    table: { type: 'string', description: 'Explicit quote table if you know it' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'list_quotes',
+            description: 'List CPQ/sales quotes with optional filters (state, account)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    table: { type: 'string', description: 'Explicit quote table if you know it' },
+                    state: { type: 'string', description: 'Filter by state' },
+                    account: { type: 'string', description: 'Filter by account sys_id' },
+                    limit: { type: 'number', description: 'Max records (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'get_approval_history',
+            description: 'Get the approval progression/history for any record (sysapproval_approver rows, ordered)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    record: { type: 'string', description: 'sys_id of the record under approval (source record)' },
+                    limit: { type: 'number', description: 'Max approver rows (default 100)' },
+                },
+                required: ['record'],
+            },
+        },
+        {
+            name: 'preview_approval_routing',
+            description: 'Preview the planned approver path for a record before/after submission (existing sysapproval_approver rows + matching approval rules)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    record: { type: 'string', description: 'sys_id of the record to preview routing for' },
+                    table: { type: 'string', description: 'Table of the record (to match approval rules)' },
+                },
+                required: ['record'],
+            },
+        },
+        {
+            name: 'add_adhoc_approver',
+            description: 'Add an ad-hoc approver to an in-flight approval on a record (inserts a sysapproval_approver row). Requires WRITE_ENABLED=true',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    record: { type: 'string', description: 'sys_id of the record under approval (sets sysapproval)' },
+                    approver: { type: 'string', description: 'sys_id of the user to add as approver' },
+                    source_table: { type: 'string', description: 'Table of the source record (source_table field)' },
+                },
+                required: ['record', 'approver'],
+            },
+        },
+        {
+            name: 'recall_approval_request',
+            description: 'Recall/withdraw approval requests on a record by cancelling pending approver rows (state → cancelled/no_longer_required). Requires WRITE_ENABLED=true',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    record: { type: 'string', description: 'sys_id of the record whose approvals to recall' },
+                },
+                required: ['record'],
+            },
+        },
+        {
+            name: 'submit_for_approval',
+            description: 'Submit any record for approval by setting its approval field to "requested" (generic, not just change). Requires WRITE_ENABLED=true',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    table: { type: 'string', description: 'Table of the record' },
+                    sys_id: { type: 'string', description: 'sys_id of the record' },
+                    approval_field: { type: 'string', description: 'Approval field name (default "approval")' },
+                },
+                required: ['table', 'sys_id'],
+            },
+        },
+    ];
+}
+async function findQuote(client, query, tables) {
+    for (const t of tables) {
+        try {
+            const r = await client.queryRecords({ table: t, query, limit: 1 });
+            if (r.count > 0)
+                return { table: t, record: r.records[0] };
+        }
+        catch { /* table may not exist in this instance */ }
+    }
+    return null;
+}
+export async function executeApprovalsExtraToolCall(client, name, args) {
+    switch (name) {
+        case 'get_quote': {
+            const tables = args.table ? [args.table] : QUOTE_TABLES;
+            if (args.sys_id) {
+                for (const t of tables) {
+                    try {
+                        return { table: t, quote: await client.getRecord(t, args.sys_id) };
+                    }
+                    catch { /* try next */ }
+                }
+                throw new ServiceNowError('Quote not found by sys_id in known quote tables', 'NOT_FOUND');
+            }
+            if (!args.number)
+                throw new ServiceNowError('number or sys_id is required', 'INVALID_REQUEST');
+            const hit = await findQuote(client, `number=${args.number}`, tables);
+            if (!hit)
+                throw new ServiceNowError(`Quote ${args.number} not found (CPQ/Sales quote tables may not be installed)`, 'NOT_FOUND');
+            return { table: hit.table, quote: hit.record };
+        }
+        case 'list_quotes': {
+            const tables = args.table ? [args.table] : QUOTE_TABLES;
+            const parts = [];
+            if (args.state)
+                parts.push(`state=${args.state}`);
+            if (args.account)
+                parts.push(`account=${args.account}`);
+            for (const t of tables) {
+                try {
+                    const r = await client.queryRecords({ table: t, query: parts.join('^'), limit: args.limit ?? 25 });
+                    if (r.count > 0 || t === tables[tables.length - 1])
+                        return { table: t, ...r };
+                }
+                catch { /* try next */ }
+            }
+            return { count: 0, records: [], note: 'No CPQ/Sales quote table found on this instance.' };
+        }
+        case 'get_approval_history': {
+            if (!args.record)
+                throw new ServiceNowError('record is required', 'INVALID_REQUEST');
+            return await client.queryRecords({
+                table: 'sysapproval_approver',
+                query: `sysapproval=${args.record}^ORDERBYorder`,
+                fields: 'approver,approver.name,state,order,comments,sys_created_on,sys_updated_on,group',
+                limit: args.limit ?? 100,
+            });
+        }
+        case 'preview_approval_routing': {
+            if (!args.record)
+                throw new ServiceNowError('record is required', 'INVALID_REQUEST');
+            const existing = await client.queryRecords({
+                table: 'sysapproval_approver',
+                query: `sysapproval=${args.record}^ORDERBYorder`,
+                fields: 'approver,approver.name,state,order,group,group.name',
+                limit: 100,
+            });
+            let rules = { records: [], count: 0 };
+            if (args.table) {
+                rules = await client.queryRecords({
+                    table: 'sysrule_assignment',
+                    query: `table=${args.table}`,
+                    fields: 'name,order,active',
+                    limit: 20,
+                }).catch(() => ({ records: [], count: 0 }));
+            }
+            return {
+                record: args.record,
+                planned_approvers: existing.records,
+                matching_assignment_rules: rules.records,
+                note: 'Shows current sysapproval_approver rows (the actual planned path) plus any assignment rules for the table. A full pre-submission dry-run requires the record to be evaluated by the workflow engine.',
+            };
+        }
+        case 'add_adhoc_approver': {
+            requireWrite();
+            if (!args.record || !args.approver)
+                throw new ServiceNowError('record and approver are required', 'INVALID_REQUEST');
+            const payload = { sysapproval: args.record, approver: args.approver, state: 'requested' };
+            if (args.source_table)
+                payload.source_table = args.source_table;
+            const result = await client.createRecord('sysapproval_approver', payload);
+            return { ...result, summary: `Added ad-hoc approver ${args.approver} to record ${args.record}` };
+        }
+        case 'recall_approval_request': {
+            requireWrite();
+            if (!args.record)
+                throw new ServiceNowError('record is required', 'INVALID_REQUEST');
+            const pending = await client.queryRecords({ table: 'sysapproval_approver', query: `sysapproval=${args.record}^stateIN requested,not requested`, fields: 'sys_id', limit: 100 });
+            let cancelled = 0;
+            for (const r of pending.records) {
+                await client.updateRecord('sysapproval_approver', r.sys_id, { state: 'cancelled' }).then(() => cancelled++).catch(() => { });
+            }
+            return { record: args.record, cancelled, summary: `Recalled ${cancelled} pending approval request(s)` };
+        }
+        case 'submit_for_approval': {
+            requireWrite();
+            if (!args.table || !args.sys_id)
+                throw new ServiceNowError('table and sys_id are required', 'INVALID_REQUEST');
+            const field = args.approval_field || 'approval';
+            const result = await client.updateRecord(args.table, args.sys_id, { [field]: 'requested' });
+            return { ...result, summary: `Submitted ${args.table}/${args.sys_id} for approval (${field}=requested)` };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=approvals-extra.js.map

package/dist/tools/approvals-extra.js.map

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

package/dist/tools/catalog-fulfillment.d.ts

@@ -0,0 +1,349 @@
+/**
+ * Catalog fulfillment + user criteria tools. Read: Tier 0. Create/update: Tier 1.
+ *
+ * Tables:
+ *   sc_req_item                     — requested items (RITM)
+ *   sc_task                         — catalog fulfillment tasks (SCTASK)
+ *   sc_category                     — catalog categories
+ *   user_criteria                   — audience/entitlement criteria
+ *   sc_cat_item_user_criteria_mtom  — criteria ↔ catalog item link (available-for)
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getCatalogFulfillmentToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            number: {
+                type: string;
+                description: string;
+            };
+            sys_id: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            stage?: undefined;
+            fields?: undefined;
+            request_item?: undefined;
+            assignment_group?: undefined;
+            active?: undefined;
+            limit?: undefined;
+            close_notes?: undefined;
+            catalog?: undefined;
+            query?: undefined;
+            title?: undefined;
+            description?: undefined;
+            parent?: undefined;
+            name?: undefined;
+            roles?: undefined;
+            groups?: undefined;
+            users?: undefined;
+            match_all?: undefined;
+            catalog_item?: undefined;
+            user_criteria?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            sys_id: {
+                type: string;
+                description: string;
+            };
+            state: {
+                type: string;
+                description: string;
+            };
+            stage: {
+                type: string;
+                description: string;
+            };
+            fields: {
+                type: string;
+                description: string;
+            };
+            number?: undefined;
+            request_item?: undefined;
+            assignment_group?: undefined;
+            active?: undefined;
+            limit?: undefined;
+            close_notes?: undefined;
+            catalog?: undefined;
+            query?: undefined;
+            title?: undefined;
+            description?: undefined;
+            parent?: undefined;
+            name?: undefined;
+            roles?: undefined;
+            groups?: undefined;
+            users?: undefined;
+            match_all?: undefined;
+            catalog_item?: undefined;
+            user_criteria?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            request_item: {
+                type: string;
+                description: string;
+            };
+            assignment_group: {
+                type: string;
+                description: string;
+            };
+            active: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            number?: undefined;
+            sys_id?: undefined;
+            state?: undefined;
+            stage?: undefined;
+            fields?: undefined;
+            close_notes?: undefined;
+            catalog?: undefined;
+            query?: undefined;
+            title?: undefined;
+            description?: undefined;
+            parent?: undefined;
+            name?: undefined;
+            roles?: undefined;
+            groups?: undefined;
+            users?: undefined;
+            match_all?: undefined;
+            catalog_item?: undefined;
+            user_criteria?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            sys_id: {
+                type: string;
+                description: string;
+            };
+            close_notes: {
+                type: string;
+                description: string;
+            };
+            state: {
+                type: string;
+                description: string;
+            };
+            number?: undefined;
+            stage?: undefined;
+            fields?: undefined;
+            request_item?: undefined;
+            assignment_group?: undefined;
+            active?: undefined;
+            limit?: undefined;
+            catalog?: undefined;
+            query?: undefined;
+            title?: undefined;
+            description?: undefined;
+            parent?: undefined;
+            name?: undefined;
+            roles?: undefined;
+            groups?: undefined;
+            users?: undefined;
+            match_all?: undefined;
+            catalog_item?: undefined;
+            user_criteria?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            catalog: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            number?: undefined;
+            sys_id?: undefined;
+            state?: undefined;
+            stage?: undefined;
+            fields?: undefined;
+            request_item?: undefined;
+            assignment_group?: undefined;
+            active?: undefined;
+            close_notes?: undefined;
+            title?: undefined;
+            description?: undefined;
+            parent?: undefined;
+            name?: undefined;
+            roles?: undefined;
+            groups?: undefined;
+            users?: undefined;
+            match_all?: undefined;
+            catalog_item?: undefined;
+            user_criteria?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            title: {
+                type: string;
+                description: string;
+            };
+            catalog: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            parent: {
+                type: string;
+                description: string;
+            };
+            fields: {
+                type: string;
+                description: string;
+            };
+            number?: undefined;
+            sys_id?: undefined;
+            state?: undefined;
+            stage?: undefined;
+            request_item?: undefined;
+            assignment_group?: undefined;
+            active?: undefined;
+            limit?: undefined;
+            close_notes?: undefined;
+            query?: undefined;
+            name?: undefined;
+            roles?: undefined;
+            groups?: undefined;
+            users?: undefined;
+            match_all?: undefined;
+            catalog_item?: undefined;
+            user_criteria?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            roles: {
+                type: string;
+                description: string;
+            };
+            groups: {
+                type: string;
+                description: string;
+            };
+            users: {
+                type: string;
+                description: string;
+            };
+            match_all: {
+                type: string;
+                description: string;
+            };
+            fields: {
+                type: string;
+                description: string;
+            };
+            number?: undefined;
+            sys_id?: undefined;
+            state?: undefined;
+            stage?: undefined;
+            request_item?: undefined;
+            assignment_group?: undefined;
+            active?: undefined;
+            limit?: undefined;
+            close_notes?: undefined;
+            catalog?: undefined;
+            query?: undefined;
+            title?: undefined;
+            description?: undefined;
+            parent?: undefined;
+            catalog_item?: undefined;
+            user_criteria?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            catalog_item: {
+                type: string;
+                description: string;
+            };
+            user_criteria: {
+                type: string;
+                description: string;
+            };
+            number?: undefined;
+            sys_id?: undefined;
+            state?: undefined;
+            stage?: undefined;
+            fields?: undefined;
+            request_item?: undefined;
+            assignment_group?: undefined;
+            active?: undefined;
+            limit?: undefined;
+            close_notes?: undefined;
+            catalog?: undefined;
+            query?: undefined;
+            title?: undefined;
+            description?: undefined;
+            parent?: undefined;
+            name?: undefined;
+            roles?: undefined;
+            groups?: undefined;
+            users?: undefined;
+            match_all?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare function executeCatalogFulfillmentToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=catalog-fulfillment.d.ts.map

package/dist/tools/catalog-fulfillment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-fulfillment.d.ts","sourceRoot":"","sources":["../../src/tools/catalog-fulfillment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,wBAAgB,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAgHnD;AAED,wBAAsB,iCAAiC,CACrD,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAkFd"}