nowaikit 4.11.0 → 4.12.0

package/dist/tools/catalog-fulfillment.js

@@ -0,0 +1,222 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireWrite } from '../utils/permissions.js';
+export function getCatalogFulfillmentToolDefinitions() {
+    return [
+        {
+            name: 'get_request_item',
+            description: 'Get a requested item (RITM) with its variables, by number or sys_id',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    number: { type: 'string', description: 'RITM number (e.g. RITM0010001)' },
+                    sys_id: { type: 'string', description: 'sys_id of the sc_req_item' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'update_request_item',
+            description: 'Update the state/stage or fields of a requested item (sc_req_item). Requires WRITE_ENABLED=true',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'sys_id of the RITM' },
+                    state: { type: 'string', description: 'New state value' },
+                    stage: { type: 'string', description: 'New stage value' },
+                    fields: { type: 'object', description: 'Additional field values' },
+                },
+                required: ['sys_id'],
+            },
+        },
+        {
+            name: 'list_catalog_tasks',
+            description: 'List catalog fulfillment tasks (SCTASK), optionally by request item, assignment group, or state',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    request_item: { type: 'string', description: 'Parent RITM sys_id' },
+                    assignment_group: { type: 'string', description: 'Assignment group sys_id' },
+                    active: { type: 'boolean', description: 'Filter to active tasks only' },
+                    limit: { type: 'number', description: 'Max records (default 50)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'complete_catalog_task',
+            description: 'Close a catalog fulfillment task (sc_task) as complete. Requires WRITE_ENABLED=true',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'sys_id of the SCTASK' },
+                    close_notes: { type: 'string', description: 'Closure notes' },
+                    state: { type: 'string', description: 'Closed state value (default 3 = Closed Complete)' },
+                },
+                required: ['sys_id'],
+            },
+        },
+        {
+            name: 'list_catalog_categories',
+            description: 'List catalog categories (sc_category), optionally filtered by catalog or title',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    catalog: { type: 'string', description: 'Catalog sys_id to filter by' },
+                    query: { type: 'string', description: 'Search categories by title' },
+                    limit: { type: 'number', description: 'Max records (default 50)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'create_catalog_category',
+            description: 'Create a catalog category (sc_category). Requires WRITE_ENABLED=true',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Category title' },
+                    catalog: { type: 'string', description: 'Catalog sys_id (sc_catalog)' },
+                    description: { type: 'string', description: 'Category description' },
+                    parent: { type: 'string', description: 'Parent category sys_id (for sub-categories)' },
+                    fields: { type: 'object', description: 'Additional field values' },
+                },
+                required: ['title'],
+            },
+        },
+        {
+            name: 'create_user_criteria',
+            description: 'Create a user criteria record (user_criteria) for catalog entitlement/audience. Requires WRITE_ENABLED=true',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'User criteria name' },
+                    roles: { type: 'string', description: 'Comma-separated role sys_ids' },
+                    groups: { type: 'string', description: 'Comma-separated group sys_ids' },
+                    users: { type: 'string', description: 'Comma-separated user sys_ids' },
+                    match_all: { type: 'boolean', description: 'Require all conditions to match' },
+                    fields: { type: 'object', description: 'Additional field values' },
+                },
+                required: ['name'],
+            },
+        },
+        {
+            name: 'assign_user_criteria',
+            description: 'Attach a user criteria to a catalog item as available-for (sc_cat_item_user_criteria_mtom). Requires WRITE_ENABLED=true',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    catalog_item: { type: 'string', description: 'sys_id of the catalog item (sc_cat_item)' },
+                    user_criteria: { type: 'string', description: 'sys_id of the user_criteria record' },
+                },
+                required: ['catalog_item', 'user_criteria'],
+            },
+        },
+    ];
+}
+export async function executeCatalogFulfillmentToolCall(client, name, args) {
+    switch (name) {
+        case 'get_request_item': {
+            let ritm;
+            if (args.sys_id) {
+                ritm = await client.getRecord('sc_req_item', args.sys_id);
+            }
+            else if (args.number) {
+                const resp = await client.queryRecords({ table: 'sc_req_item', query: `number=${args.number}`, limit: 1 });
+                if (resp.count === 0)
+                    throw new ServiceNowError(`RITM not found: ${args.number}`, 'NOT_FOUND');
+                ritm = resp.records[0];
+            }
+            else {
+                throw new ServiceNowError('number or sys_id is required', 'INVALID_REQUEST');
+            }
+            const sysId = ritm.sys_id;
+            const vars = await client
+                .queryRecords({ table: 'sc_item_option_mtom', query: `request_item=${sysId}`, fields: 'sc_item_option.item_option_new.question_text,sc_item_option.value', limit: 100 })
+                .catch(() => ({ records: [] }));
+            return { request_item: ritm, variables: vars.records };
+        }
+        case 'update_request_item': {
+            requireWrite();
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            const payload = { ...(args.fields ?? {}) };
+            if (args.state !== undefined)
+                payload.state = args.state;
+            if (args.stage !== undefined)
+                payload.stage = args.stage;
+            const result = await client.updateRecord('sc_req_item', args.sys_id, payload);
+            return { ...result, summary: `Updated RITM ${args.sys_id}` };
+        }
+        case 'list_catalog_tasks': {
+            const parts = [];
+            if (args.request_item)
+                parts.push(`request_item=${args.request_item}`);
+            if (args.assignment_group)
+                parts.push(`assignment_group=${args.assignment_group}`);
+            if (args.active !== undefined)
+                parts.push(`active=${args.active ? 'true' : 'false'}`);
+            return await client.queryRecords({ table: 'sc_task', query: parts.join('^'), limit: args.limit ?? 50 });
+        }
+        case 'complete_catalog_task': {
+            requireWrite();
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            const payload = { state: args.state ?? '3' };
+            if (args.close_notes)
+                payload.close_notes = args.close_notes;
+            const result = await client.updateRecord('sc_task', args.sys_id, payload);
+            return { ...result, summary: `Closed catalog task ${args.sys_id}` };
+        }
+        case 'list_catalog_categories': {
+            const parts = [];
+            if (args.catalog)
+                parts.push(`sc_catalog=${args.catalog}`);
+            if (args.query)
+                parts.push(`titleCONTAINS${args.query}`);
+            return await client.queryRecords({ table: 'sc_category', query: parts.join('^'), limit: args.limit ?? 50 });
+        }
+        case 'create_catalog_category': {
+            requireWrite();
+            if (!args.title)
+                throw new ServiceNowError('title is required', 'INVALID_REQUEST');
+            const payload = { title: args.title, ...(args.fields ?? {}) };
+            if (args.catalog)
+                payload.sc_catalog = args.catalog;
+            if (args.description)
+                payload.description = args.description;
+            if (args.parent)
+                payload.parent = args.parent;
+            const result = await client.createRecord('sc_category', payload);
+            return { ...result, summary: `Created catalog category "${args.title}"` };
+        }
+        case 'create_user_criteria': {
+            requireWrite();
+            if (!args.name)
+                throw new ServiceNowError('name is required', 'INVALID_REQUEST');
+            const payload = { name: args.name, ...(args.fields ?? {}) };
+            if (args.roles)
+                payload.role = args.roles;
+            if (args.groups)
+                payload.group = args.groups;
+            if (args.users)
+                payload.user = args.users;
+            if (args.match_all !== undefined)
+                payload.match_all = args.match_all ? 'true' : 'false';
+            const result = await client.createRecord('user_criteria', payload);
+            return { ...result, summary: `Created user criteria "${args.name}"` };
+        }
+        case 'assign_user_criteria': {
+            requireWrite();
+            if (!args.catalog_item || !args.user_criteria)
+                throw new ServiceNowError('catalog_item and user_criteria are required', 'INVALID_REQUEST');
+            const result = await client.createRecord('sc_cat_item_user_criteria_mtom', {
+                sc_cat_item: args.catalog_item,
+                user_criteria: args.user_criteria,
+            });
+            return { ...result, summary: `Linked user criteria ${args.user_criteria} to catalog item ${args.catalog_item}` };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=catalog-fulfillment.js.map

package/dist/tools/catalog-fulfillment.js.map

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

package/dist/tools/grc-extra.d.ts

@@ -0,0 +1,149 @@
+/**
+ * GRC / IRM authoring depth (controls, issues, control tests).
+ * Read: Tier 0. Create/run: Tier 1 (WRITE_ENABLED=true).
+ *
+ * Tables (may vary by IRM version):
+ *   sn_compliance_control       — compliance controls
+ *   sn_compliance_control_test  — control tests/attestations
+ *   sn_grc_issue                — GRC issues/findings
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getGrcExtraToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            state: {
+                type: string;
+                description: string;
+            };
+            owner: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            short_description?: undefined;
+            description?: undefined;
+            source?: undefined;
+            fields?: undefined;
+            name?: undefined;
+            profile?: undefined;
+            control?: undefined;
+            result?: undefined;
+            notes?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            short_description: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            source: {
+                type: string;
+                description: string;
+            };
+            fields: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            owner?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            name?: undefined;
+            profile?: undefined;
+            control?: undefined;
+            result?: undefined;
+            notes?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            profile: {
+                type: string;
+                description: string;
+            };
+            fields: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            owner?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            short_description?: undefined;
+            source?: undefined;
+            control?: undefined;
+            result?: undefined;
+            notes?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            control: {
+                type: string;
+                description: string;
+            };
+            result: {
+                type: string;
+                description: string;
+            };
+            notes: {
+                type: string;
+                description: string;
+            };
+            fields: {
+                type: string;
+                description: string;
+            };
+            state?: undefined;
+            owner?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            short_description?: undefined;
+            description?: undefined;
+            source?: undefined;
+            name?: undefined;
+            profile?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare function executeGrcExtraToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=grc-extra.d.ts.map

package/dist/tools/grc-extra.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grc-extra.d.ts","sourceRoot":"","sources":["../../src/tools/grc-extra.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,wBAAgB,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA2DzC;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,CAuCd"}

package/dist/tools/grc-extra.js

@@ -0,0 +1,115 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireWrite } from '../utils/permissions.js';
+export function getGrcExtraToolDefinitions() {
+    return [
+        {
+            name: 'list_grc_issues',
+            description: 'List GRC issues/findings (sn_grc_issue), optionally by state or owner',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    state: { type: 'string', description: 'Issue state filter' },
+                    owner: { type: 'string', description: 'Owner/assigned user sys_id' },
+                    query: { type: 'string', description: 'Search issues by short description' },
+                    limit: { type: 'number', description: 'Max records (default 50)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'create_grc_issue',
+            description: 'Raise a GRC issue/finding (sn_grc_issue). Requires WRITE_ENABLED=true',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    short_description: { type: 'string', description: 'Issue summary' },
+                    description: { type: 'string', description: 'Full description' },
+                    source: { type: 'string', description: 'Source record sys_id (control/risk/audit)' },
+                    fields: { type: 'object', description: 'Additional field values' },
+                },
+                required: ['short_description'],
+            },
+        },
+        {
+            name: 'create_grc_control',
+            description: 'Author a compliance control (sn_compliance_control). Requires WRITE_ENABLED=true',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Control name' },
+                    description: { type: 'string', description: 'Control description' },
+                    profile: { type: 'string', description: 'Related profile/entity sys_id' },
+                    fields: { type: 'object', description: 'Additional field values' },
+                },
+                required: ['name'],
+            },
+        },
+        {
+            name: 'run_control_test',
+            description: 'Create/attest a control test (sn_compliance_control_test). Requires WRITE_ENABLED=true',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    control: { type: 'string', description: 'sys_id of the control (sn_compliance_control)' },
+                    result: { type: 'string', description: 'Test result/state (e.g. "pass", "fail")' },
+                    notes: { type: 'string', description: 'Test notes/evidence' },
+                    fields: { type: 'object', description: 'Additional field values' },
+                },
+                required: ['control'],
+            },
+        },
+    ];
+}
+export async function executeGrcExtraToolCall(client, name, args) {
+    switch (name) {
+        case 'list_grc_issues': {
+            const parts = [];
+            if (args.state)
+                parts.push(`state=${args.state}`);
+            if (args.owner)
+                parts.push(`assigned_to=${args.owner}`);
+            if (args.query)
+                parts.push(`short_descriptionCONTAINS${args.query}`);
+            return await client.queryRecords({ table: 'sn_grc_issue', query: parts.join('^'), limit: args.limit ?? 50 });
+        }
+        case 'create_grc_issue': {
+            requireWrite();
+            if (!args.short_description)
+                throw new ServiceNowError('short_description is required', 'INVALID_REQUEST');
+            const payload = { short_description: args.short_description, ...(args.fields ?? {}) };
+            if (args.description)
+                payload.description = args.description;
+            if (args.source)
+                payload.source = args.source;
+            const result = await client.createRecord('sn_grc_issue', payload);
+            return { ...result, summary: `Created GRC issue "${args.short_description}"` };
+        }
+        case 'create_grc_control': {
+            requireWrite();
+            if (!args.name)
+                throw new ServiceNowError('name is required', 'INVALID_REQUEST');
+            const payload = { name: args.name, ...(args.fields ?? {}) };
+            if (args.description)
+                payload.description = args.description;
+            if (args.profile)
+                payload.profile = args.profile;
+            const result = await client.createRecord('sn_compliance_control', payload);
+            return { ...result, summary: `Created control "${args.name}"` };
+        }
+        case 'run_control_test': {
+            requireWrite();
+            if (!args.control)
+                throw new ServiceNowError('control is required', 'INVALID_REQUEST');
+            const payload = { control: args.control, ...(args.fields ?? {}) };
+            if (args.result)
+                payload.state = args.result;
+            if (args.notes)
+                payload.notes = args.notes;
+            const result = await client.createRecord('sn_compliance_control_test', payload);
+            return { ...result, summary: `Recorded control test for ${args.control}` };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=grc-extra.js.map

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

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