nowaikit 2.5.0

package/dist/tools/app-studio.js

@@ -0,0 +1,139 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireWrite } from '../utils/permissions.js';
+export function getAppStudioToolDefinitions() {
+    return [
+        // ── Scoped Applications ─────────────────────────────────────────────────
+        {
+            name: 'list_scoped_apps',
+            description: 'List scoped applications (custom apps) installed in the instance',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Search apps by name or scope prefix' },
+                    active: { type: 'boolean', description: 'Filter to active apps only' },
+                    limit: { type: 'number', description: 'Max records to return (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'get_scoped_app',
+            description: 'Get full details of a scoped application by sys_id or scope name',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string', description: 'App sys_id or scope name (e.g. "x_myco_myapp")' },
+                },
+                required: ['id'],
+            },
+        },
+        {
+            name: 'create_scoped_app',
+            description: 'Create a new scoped application in App Studio (requires WRITE_ENABLED=true). ' +
+                'The scope prefix must be unique and follow the pattern x_<vendor>_<appname>.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Human-readable application name' },
+                    scope: {
+                        type: 'string',
+                        description: 'Unique scope prefix, e.g. "x_myco_myapp". Must start with "x_".',
+                    },
+                    version: {
+                        type: 'string',
+                        description: 'Application version string (e.g. "1.0.0"). Defaults to "1.0.0".',
+                    },
+                    short_description: { type: 'string', description: 'Short description shown in the app list' },
+                    description: { type: 'string', description: 'Full description of the application' },
+                    vendor: { type: 'string', description: 'Vendor or author name' },
+                    active: { type: 'boolean', description: 'Activate the app immediately (default: true)' },
+                    logo: { type: 'string', description: 'App logo attachment sys_id (optional)' },
+                },
+                required: ['name', 'scope'],
+            },
+        },
+        {
+            name: 'update_scoped_app',
+            description: 'Update an existing scoped application (requires WRITE_ENABLED=true)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'App sys_id' },
+                    fields: {
+                        type: 'object',
+                        description: 'Fields to update (name, version, short_description, description, active, vendor, etc.)',
+                    },
+                },
+                required: ['sys_id', 'fields'],
+            },
+        },
+    ];
+}
+export async function executeAppStudioToolCall(client, name, args) {
+    switch (name) {
+        case 'list_scoped_apps': {
+            const parts = [];
+            if (args.active !== undefined)
+                parts.push(`active=${args.active}`);
+            if (args.query)
+                parts.push(`nameCONTAINS${args.query}^ORscopeCONTAINS${args.query}`);
+            return await client.queryRecords({
+                table: 'sys_app',
+                query: parts.join('^') || undefined,
+                limit: args.limit ?? 25,
+                fields: 'sys_id,name,scope,version,short_description,active,vendor,sys_updated_on',
+            });
+        }
+        case 'get_scoped_app': {
+            if (!args.id)
+                throw new ServiceNowError('id is required', 'INVALID_REQUEST');
+            if (/^[0-9a-f]{32}$/i.test(args.id)) {
+                return await client.getRecord('sys_app', args.id);
+            }
+            const resp = await client.queryRecords({
+                table: 'sys_app',
+                query: `scope=${args.id}^ORname=${args.id}`,
+                limit: 1,
+            });
+            if (resp.count === 0)
+                throw new ServiceNowError(`Scoped app not found: ${args.id}`, 'NOT_FOUND');
+            return resp.records[0];
+        }
+        case 'create_scoped_app': {
+            requireWrite();
+            if (!args.name || !args.scope)
+                throw new ServiceNowError('name and scope are required', 'INVALID_REQUEST');
+            if (!args.scope.startsWith('x_'))
+                throw new ServiceNowError('scope must start with "x_" (e.g. x_myco_myapp)', 'INVALID_REQUEST');
+            const data = {
+                name: args.name,
+                scope: args.scope,
+                version: args.version ?? '1.0.0',
+                active: args.active !== false,
+            };
+            if (args.short_description)
+                data.short_description = args.short_description;
+            if (args.description)
+                data.description = args.description;
+            if (args.vendor)
+                data.vendor = args.vendor;
+            if (args.logo)
+                data.logo = args.logo;
+            const result = await client.createRecord('sys_app', data);
+            return {
+                ...result,
+                summary: `Created scoped app "${args.name}" with scope "${args.scope}"`,
+            };
+        }
+        case 'update_scoped_app': {
+            requireWrite();
+            if (!args.sys_id || !args.fields)
+                throw new ServiceNowError('sys_id and fields are required', 'INVALID_REQUEST');
+            const result = await client.updateRecord('sys_app', args.sys_id, args.fields);
+            return { ...result, summary: `Updated scoped app ${args.sys_id}` };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=app-studio.js.map

package/dist/tools/app-studio.js.map

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

package/dist/tools/atf.d.ts

@@ -0,0 +1,144 @@
+/**
+ * ATF (Automated Test Framework) tools — latest release.
+ * Read tools: Tier 0. Execution tools require ATF_ENABLED=true.
+ * Latest release added: Failure Insight (get_atf_failure_insight) showing metadata diffs.
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getAtfToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            active: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            sys_id_or_name?: undefined;
+            sys_id?: undefined;
+            suite_sys_id?: undefined;
+            result_sys_id?: undefined;
+            suite_result_sys_id?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            sys_id_or_name: {
+                type: string;
+                description: string;
+            };
+            active?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            sys_id?: undefined;
+            suite_sys_id?: undefined;
+            result_sys_id?: undefined;
+            suite_result_sys_id?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            sys_id: {
+                type: string;
+                description: string;
+            };
+            active?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            sys_id_or_name?: undefined;
+            suite_sys_id?: undefined;
+            result_sys_id?: undefined;
+            suite_result_sys_id?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            suite_sys_id: {
+                type: string;
+                description: string;
+            };
+            active: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            query?: undefined;
+            sys_id_or_name?: undefined;
+            sys_id?: undefined;
+            result_sys_id?: undefined;
+            suite_result_sys_id?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            result_sys_id: {
+                type: string;
+                description: string;
+            };
+            active?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            sys_id_or_name?: undefined;
+            sys_id?: undefined;
+            suite_sys_id?: undefined;
+            suite_result_sys_id?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            suite_result_sys_id: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            active?: undefined;
+            query?: undefined;
+            sys_id_or_name?: undefined;
+            sys_id?: undefined;
+            suite_sys_id?: undefined;
+            result_sys_id?: undefined;
+        };
+        required: never[];
+    };
+})[];
+export declare function executeAtfToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=atf.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"atf.d.ts","sourceRoot":"","sources":["../../src/tools/atf.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,wBAAgB,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA2GpC;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAgEd"}

package/dist/tools/atf.js

@@ -0,0 +1,186 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireAtf } from '../utils/permissions.js';
+export function getAtfToolDefinitions() {
+    return [
+        {
+            name: 'list_atf_suites',
+            description: 'List ATF test suites in the instance',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    active: { type: 'boolean', description: 'Filter to active suites only' },
+                    query: { type: 'string', description: 'Additional filter' },
+                    limit: { type: 'number', description: 'Max results (default: 20)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'get_atf_suite',
+            description: 'Get details of a test suite including test count',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id_or_name: { type: 'string', description: 'Test suite sys_id or name' },
+                },
+                required: ['sys_id_or_name'],
+            },
+        },
+        {
+            name: 'run_atf_suite',
+            description: 'Execute an ATF test suite (requires ATF_ENABLED=true)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'System ID of the test suite' },
+                },
+                required: ['sys_id'],
+            },
+        },
+        {
+            name: 'list_atf_tests',
+            description: 'List ATF test cases, optionally filtered by suite',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    suite_sys_id: { type: 'string', description: 'Filter by test suite sys_id' },
+                    active: { type: 'boolean', description: 'Filter to active tests only' },
+                    limit: { type: 'number', description: 'Max results (default: 20)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'get_atf_test',
+            description: 'Get details of a specific test case',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'System ID of the test' },
+                },
+                required: ['sys_id'],
+            },
+        },
+        {
+            name: 'run_atf_test',
+            description: 'Execute a single ATF test (requires ATF_ENABLED=true)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'System ID of the test' },
+                },
+                required: ['sys_id'],
+            },
+        },
+        {
+            name: 'get_atf_suite_result',
+            description: 'Get the results of a test suite run',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    result_sys_id: { type: 'string', description: 'System ID of the suite result record' },
+                },
+                required: ['result_sys_id'],
+            },
+        },
+        {
+            name: 'list_atf_test_results',
+            description: 'List individual test results within a suite run',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    suite_result_sys_id: { type: 'string', description: 'Filter by suite result sys_id' },
+                    limit: { type: 'number', description: 'Max results (default: 50)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'get_atf_failure_insight',
+            description: 'Get ATF Failure Insight data — metadata changes between last successful and failed run (role changes, field value changes)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    result_sys_id: { type: 'string', description: 'System ID of the failed suite result' },
+                },
+                required: ['result_sys_id'],
+            },
+        },
+    ];
+}
+export async function executeAtfToolCall(client, name, args) {
+    switch (name) {
+        case 'list_atf_suites': {
+            let query = args.active !== false ? 'active=true' : '';
+            if (args.query)
+                query = query ? `${query}^${args.query}` : args.query;
+            const resp = await client.queryRecords({ table: 'sys_atf_test_suite', query: query || undefined, limit: args.limit || 20, fields: 'sys_id,name,active,description,sys_updated_on' });
+            return { count: resp.count, suites: resp.records };
+        }
+        case 'get_atf_suite': {
+            if (!args.sys_id_or_name)
+                throw new ServiceNowError('sys_id_or_name is required', 'INVALID_REQUEST');
+            if (/^[0-9a-f]{32}$/i.test(args.sys_id_or_name)) {
+                return await client.getRecord('sys_atf_test_suite', args.sys_id_or_name);
+            }
+            const resp = await client.queryRecords({ table: 'sys_atf_test_suite', query: `name=${args.sys_id_or_name}`, limit: 1 });
+            if (resp.count === 0)
+                throw new ServiceNowError(`Test suite not found: ${args.sys_id_or_name}`, 'NOT_FOUND');
+            return resp.records[0];
+        }
+        case 'run_atf_suite': {
+            requireAtf();
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            // ServiceNow ATF runner API: POST /api/now/atf/runner/run_suite
+            const result = await client.callNowAssist('/api/now/atf/runner/run_suite', { sys_id: args.sys_id });
+            return { ...result, summary: `Started test suite ${args.sys_id}` };
+        }
+        case 'list_atf_tests': {
+            let query = args.active !== false ? 'active=true' : '';
+            if (args.suite_sys_id)
+                query = query ? `${query}^test_suite=${args.suite_sys_id}` : `test_suite=${args.suite_sys_id}`;
+            const resp = await client.queryRecords({ table: 'sys_atf_test', query: query || undefined, limit: args.limit || 20 });
+            return { count: resp.count, tests: resp.records };
+        }
+        case 'get_atf_test': {
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            return await client.getRecord('sys_atf_test', args.sys_id);
+        }
+        case 'run_atf_test': {
+            requireAtf();
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            const result = await client.callNowAssist('/api/now/atf/runner/run_test', { sys_id: args.sys_id });
+            return { ...result, summary: `Started test ${args.sys_id}` };
+        }
+        case 'get_atf_suite_result': {
+            if (!args.result_sys_id)
+                throw new ServiceNowError('result_sys_id is required', 'INVALID_REQUEST');
+            return await client.getRecord('sys_atf_test_suite_result', args.result_sys_id);
+        }
+        case 'list_atf_test_results': {
+            let query = '';
+            if (args.suite_result_sys_id)
+                query = `test_suite_result=${args.suite_result_sys_id}`;
+            const resp = await client.queryRecords({ table: 'sys_atf_result', query: query || undefined, limit: args.limit || 50, fields: 'sys_id,test,status,message,test_suite_result,sys_updated_on' });
+            return { count: resp.count, results: resp.records };
+        }
+        case 'get_atf_failure_insight': {
+            if (!args.result_sys_id)
+                throw new ServiceNowError('result_sys_id is required', 'INVALID_REQUEST');
+            // ATF Failure Insight: query sys_atf_failure_insight table
+            const resp = await client.queryRecords({ table: 'sys_atf_failure_insight', query: `test_suite_result=${args.result_sys_id}` });
+            return {
+                result_sys_id: args.result_sys_id,
+                failure_insight: resp.records,
+                summary: `Found ${resp.count} metadata change(s) between last passing and failing run`,
+                note: 'Failure Insight (latest release) surfaces role changes, field value changes, and configuration diffs that caused test failures',
+            };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=atf.js.map

package/dist/tools/atf.js.map

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