nowaikit 2.5.0

package/dist/tools/itam.js

@@ -0,0 +1,306 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireWrite } from '../utils/permissions.js';
+export function getItamToolDefinitions() {
+    return [
+        {
+            name: 'list_assets',
+            description: 'List IT assets with optional filtering by state, class, or assigned user',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    asset_class: { type: 'string', description: 'Asset class: "alm_hardware", "alm_license", "alm_consumable"' },
+                    state: { type: 'string', description: 'Asset state: "in_use", "in_stock", "retired", "missing"' },
+                    assigned_to: { type: 'string', description: 'User sys_id to filter by assignee' },
+                    location: { type: 'string', description: 'Location name or sys_id' },
+                    query: { type: 'string', description: 'Additional encoded query' },
+                    limit: { type: 'number', description: 'Max records (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'get_asset',
+            description: 'Get full details of an IT asset including financial and lifecycle data',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'Asset sys_id' },
+                },
+                required: ['sys_id'],
+            },
+        },
+        {
+            name: 'create_asset',
+            description: 'Create a new IT asset record. **[Write]**',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    display_name: { type: 'string', description: 'Asset display name' },
+                    asset_tag: { type: 'string', description: 'Unique asset tag' },
+                    model_category: { type: 'string', description: 'Category sys_id (Hardware, Software, etc.)' },
+                    model: { type: 'string', description: 'Model sys_id' },
+                    serial_number: { type: 'string', description: 'Serial number' },
+                    assigned_to: { type: 'string', description: 'User sys_id' },
+                    location: { type: 'string', description: 'Location sys_id' },
+                    cost: { type: 'number', description: 'Purchase cost' },
+                    cost_center: { type: 'string', description: 'Cost center sys_id' },
+                    purchase_date: { type: 'string', description: 'Purchase date (YYYY-MM-DD)' },
+                },
+                required: ['display_name'],
+            },
+        },
+        {
+            name: 'update_asset',
+            description: 'Update an IT asset record. **[Write]**',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'Asset sys_id' },
+                    fields: { type: 'object', description: 'Fields to update' },
+                },
+                required: ['sys_id', 'fields'],
+            },
+        },
+        {
+            name: 'retire_asset',
+            description: 'Retire an IT asset (mark as disposed/retired). **[Write]**',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'Asset sys_id' },
+                    disposal_reason: { type: 'string', description: 'Reason for retirement' },
+                    disposal_date: { type: 'string', description: 'Disposal date (YYYY-MM-DD)' },
+                },
+                required: ['sys_id'],
+            },
+        },
+        {
+            name: 'list_software_licenses',
+            description: 'List software license records with compliance status',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Encoded query filter' },
+                    limit: { type: 'number', description: 'Max records (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'get_license_compliance',
+            description: 'Get license compliance summary — purchased vs. installed vs. in use counts',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    license_sys_id: { type: 'string', description: 'Software license sys_id (optional — omit for all)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'list_asset_contracts',
+            description: 'List asset maintenance and support contracts',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    asset_sys_id: { type: 'string', description: 'Filter by linked asset' },
+                    active: { type: 'boolean', description: 'Filter to active contracts (default true)' },
+                    limit: { type: 'number', description: 'Max records (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'track_asset_lifecycle',
+            description: 'Track asset lifecycle events and stage transitions',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    asset_id: { type: 'string', description: 'Asset tag or sys_id' },
+                    new_stage: { type: 'string', description: 'Lifecycle stage: in_stock/in_use/in_maintenance/retired/disposed' },
+                    notes: { type: 'string', description: 'Transition notes' },
+                },
+                required: ['asset_id', 'new_stage'],
+            },
+        },
+        {
+            name: 'get_license_optimization',
+            description: 'Analyze software license usage and recommend optimizations',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    software_name: { type: 'string', description: 'Optional filter by software name' },
+                    threshold_pct: { type: 'number', description: 'Usage threshold percentage (default: 80)' },
+                },
+                required: [],
+            },
+        },
+    ];
+}
+export async function executeItamToolCall(client, name, args) {
+    switch (name) {
+        case 'list_assets': {
+            let query = '';
+            if (args.state)
+                query = `install_status=${args.state}`;
+            if (args.assigned_to)
+                query = query ? `${query}^assigned_to=${args.assigned_to}` : `assigned_to=${args.assigned_to}`;
+            if (args.location)
+                query = query ? `${query}^locationLIKE${args.location}` : `locationLIKE${args.location}`;
+            if (args.query)
+                query = query ? `${query}^${args.query}` : args.query;
+            const table = args.asset_class || 'alm_asset';
+            const resp = await client.queryRecords({
+                table,
+                query: query || undefined,
+                limit: args.limit || 25,
+                fields: 'sys_id,display_name,asset_tag,serial_number,install_status,assigned_to,location,cost,purchase_date,sys_updated_on',
+            });
+            return { count: resp.count, assets: resp.records };
+        }
+        case 'get_asset': {
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            const result = await client.getRecord('alm_asset', args.sys_id);
+            return result;
+        }
+        case 'create_asset': {
+            if (!args.display_name)
+                throw new ServiceNowError('display_name is required', 'INVALID_REQUEST');
+            requireWrite();
+            const payload = { display_name: args.display_name };
+            const fields = ['asset_tag', 'model_category', 'model', 'serial_number', 'assigned_to', 'location', 'cost', 'cost_center', 'purchase_date'];
+            for (const f of fields) {
+                if (args[f] !== undefined)
+                    payload[f] = args[f];
+            }
+            const result = await client.createRecord('alm_asset', payload);
+            return { action: 'created', display_name: args.display_name, ...result };
+        }
+        case 'update_asset': {
+            if (!args.sys_id || !args.fields)
+                throw new ServiceNowError('sys_id and fields are required', 'INVALID_REQUEST');
+            requireWrite();
+            const result = await client.updateRecord('alm_asset', args.sys_id, args.fields);
+            return { action: 'updated', sys_id: args.sys_id, ...result };
+        }
+        case 'retire_asset': {
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            requireWrite();
+            const payload = { install_status: 'retired' };
+            if (args.disposal_reason)
+                payload.disposal_reason = args.disposal_reason;
+            if (args.disposal_date)
+                payload.disposal_date = args.disposal_date;
+            const result = await client.updateRecord('alm_asset', args.sys_id, payload);
+            return { action: 'retired', sys_id: args.sys_id, ...result };
+        }
+        case 'list_software_licenses': {
+            const resp = await client.queryRecords({
+                table: 'alm_license',
+                query: args.query || undefined,
+                limit: args.limit || 25,
+                fields: 'sys_id,display_name,license_count,license_available,license_inuse,cost,product,vendor,expiry_date,sys_updated_on',
+            });
+            return { count: resp.count, licenses: resp.records };
+        }
+        case 'get_license_compliance': {
+            const query = args.license_sys_id ? `sys_id=${args.license_sys_id}` : undefined;
+            const resp = await client.queryRecords({
+                table: 'alm_license',
+                query,
+                limit: args.license_sys_id ? 1 : 100,
+                fields: 'sys_id,display_name,product,license_count,license_available,license_inuse,cost,expiry_date',
+            });
+            const summary = resp.records.map((r) => ({
+                license: r.display_name,
+                product: r.product,
+                purchased: r.license_count,
+                in_use: r.license_inuse,
+                available: r.license_available,
+                compliance: Number(r.license_inuse) <= Number(r.license_count) ? 'compliant' : 'over-licensed',
+                expires: r.expiry_date,
+            }));
+            return { count: resp.count, compliance_report: summary };
+        }
+        case 'list_asset_contracts': {
+            let query = args.active !== false ? 'active=true' : '';
+            if (args.asset_sys_id)
+                query = query ? `${query}^asset=${args.asset_sys_id}` : `asset=${args.asset_sys_id}`;
+            const resp = await client.queryRecords({
+                table: 'ast_contract',
+                query: query || undefined,
+                limit: args.limit || 25,
+                fields: 'sys_id,number,short_description,vendor,start_date,end_date,cost,active,sys_updated_on',
+            });
+            return { count: resp.count, contracts: resp.records };
+        }
+        case 'track_asset_lifecycle': {
+            if (!args.asset_id || !args.new_stage)
+                throw new ServiceNowError('asset_id and new_stage are required', 'INVALID_REQUEST');
+            requireWrite();
+            const stageMap = {
+                in_stock: '6', in_use: '1', in_maintenance: '7', retired: '8', disposed: '9',
+            };
+            let sysId = args.asset_id;
+            if (!/^[0-9a-f]{32}$/i.test(args.asset_id)) {
+                const resp = await client.queryRecords({ table: 'alm_asset', query: `asset_tag=${args.asset_id}^ORsys_id=${args.asset_id}`, limit: 1 });
+                if (resp.count === 0)
+                    throw new ServiceNowError(`Asset not found: ${args.asset_id}`, 'NOT_FOUND');
+                sysId = resp.records[0].sys_id;
+            }
+            const result = await client.updateRecord('alm_asset', sysId, {
+                install_status: stageMap[args.new_stage] || args.new_stage,
+                work_notes: args.notes || '',
+            });
+            return { action: 'lifecycle_updated', sys_id: sysId, new_stage: args.new_stage, ...result };
+        }
+        case 'get_license_optimization': {
+            const threshold = args.threshold_pct || 80;
+            let query = '';
+            if (args.software_name)
+                query = `display_nameLIKE${args.software_name}`;
+            const resp = await client.queryRecords({
+                table: 'alm_license',
+                query: query || undefined,
+                limit: 100,
+                fields: 'sys_id,display_name,product,license_count,license_available,license_inuse,cost,expiry_date',
+            });
+            const recommendations = resp.records.map((r) => {
+                const total = Number(r.license_count) || 0;
+                const inUse = Number(r.license_inuse) || 0;
+                const available = Number(r.license_available) || 0;
+                const usagePct = total > 0 ? Math.round((inUse / total) * 100) : 0;
+                let recommendation = 'optimal';
+                if (usagePct < threshold)
+                    recommendation = 'underutilized — consider reducing licenses';
+                if (inUse > total)
+                    recommendation = 'over-allocated — purchase additional licenses';
+                return {
+                    license: r.display_name,
+                    product: r.product,
+                    total,
+                    in_use: inUse,
+                    available,
+                    usage_pct: usagePct,
+                    cost: r.cost,
+                    expires: r.expiry_date,
+                    recommendation,
+                };
+            });
+            const underutilized = recommendations.filter((r) => r.recommendation.startsWith('underutilized'));
+            const overAllocated = recommendations.filter((r) => r.recommendation.startsWith('over-allocated'));
+            return {
+                total_licenses: resp.count,
+                threshold_pct: threshold,
+                underutilized_count: underutilized.length,
+                over_allocated_count: overAllocated.length,
+                recommendations,
+            };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=itam.js.map

package/dist/tools/itam.js.map

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

package/dist/tools/knowledge.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Knowledge Base tools.
+ * Read tools: Tier 0. Write tools: Tier 1 (WRITE_ENABLED=true).
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getKnowledgeToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            limit: {
+                type: string;
+                description: string;
+            };
+            query?: undefined;
+            knowledge_base?: undefined;
+            number_or_sysid?: undefined;
+            short_description?: undefined;
+            text?: undefined;
+            knowledge_base_sys_id?: undefined;
+            category?: undefined;
+            sys_id?: undefined;
+            fields?: undefined;
+            article_id?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            knowledge_base: {
+                type: string;
+                description: string;
+            };
+            number_or_sysid?: undefined;
+            short_description?: undefined;
+            text?: undefined;
+            knowledge_base_sys_id?: undefined;
+            category?: undefined;
+            sys_id?: undefined;
+            fields?: undefined;
+            article_id?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            number_or_sysid: {
+                type: string;
+                description: string;
+            };
+            limit?: undefined;
+            query?: undefined;
+            knowledge_base?: undefined;
+            short_description?: undefined;
+            text?: undefined;
+            knowledge_base_sys_id?: undefined;
+            category?: undefined;
+            sys_id?: undefined;
+            fields?: undefined;
+            article_id?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            short_description: {
+                type: string;
+                description: string;
+            };
+            text: {
+                type: string;
+                description: string;
+            };
+            knowledge_base_sys_id: {
+                type: string;
+                description: string;
+            };
+            category: {
+                type: string;
+                description: string;
+            };
+            limit?: undefined;
+            query?: undefined;
+            knowledge_base?: undefined;
+            number_or_sysid?: undefined;
+            sys_id?: undefined;
+            fields?: undefined;
+            article_id?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            sys_id: {
+                type: string;
+                description: string;
+            };
+            fields: {
+                type: string;
+                description: string;
+            };
+            limit?: undefined;
+            query?: undefined;
+            knowledge_base?: undefined;
+            number_or_sysid?: undefined;
+            short_description?: undefined;
+            text?: undefined;
+            knowledge_base_sys_id?: undefined;
+            category?: undefined;
+            article_id?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            sys_id: {
+                type: string;
+                description: string;
+            };
+            limit?: undefined;
+            query?: undefined;
+            knowledge_base?: undefined;
+            number_or_sysid?: undefined;
+            short_description?: undefined;
+            text?: undefined;
+            knowledge_base_sys_id?: undefined;
+            category?: undefined;
+            fields?: undefined;
+            article_id?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            article_id: {
+                type: string;
+                description: string;
+            };
+            limit?: undefined;
+            query?: undefined;
+            knowledge_base?: undefined;
+            number_or_sysid?: undefined;
+            short_description?: undefined;
+            text?: undefined;
+            knowledge_base_sys_id?: undefined;
+            category?: undefined;
+            sys_id?: undefined;
+            fields?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare function executeKnowledgeToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=knowledge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/tools/knowledge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,wBAAgB,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAsF1C;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CA8Dd"}