nowaikit 3.1.0 → 4.0.1

package/dist/tools/cmdb-reconciliation.js

@@ -0,0 +1,267 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireCmdbWrite } from '../utils/permissions.js';
+export function getCmdbReconciliationToolDefinitions() {
+    return [
+        {
+            name: 'cmdb_find_duplicates',
+            description: 'Find duplicate CIs by matching on specified fields (in-memory grouping)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    ci_class: { type: 'string', description: 'CI class table (default cmdb_ci)' },
+                    match_fields: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Fields to match on for duplicate detection (default: name, serial_number, ip_address)',
+                    },
+                    limit: { type: 'number', description: 'Max CIs to scan (default 100)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'cmdb_find_orphans',
+            description: 'Find CIs with no relationships in cmdb_rel_ci',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    ci_class: { type: 'string', description: 'CI class table (default cmdb_ci)' },
+                    limit: { type: 'number', description: 'Max orphan CIs to return (default 50)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'cmdb_find_stale',
+            description: 'Find CIs not updated within a given number of days that are still operational',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    ci_class: { type: 'string', description: 'CI class table (default cmdb_ci)' },
+                    days_threshold: { type: 'number', description: 'Number of days since last update to consider stale (default 90)' },
+                    limit: { type: 'number', description: 'Max stale CIs to return (default 50)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'cmdb_reconcile',
+            description: 'Act on duplicate, stale, or orphan CIs — merge, retire, or remove (requires CMDB_WRITE_ENABLED). Supports dry_run mode.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    action: {
+                        type: 'string',
+                        enum: ['merge_duplicates', 'retire_stale', 'remove_orphans'],
+                        description: 'Reconciliation action to perform',
+                    },
+                    targets: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Array of CI sys_ids to act on',
+                    },
+                    dry_run: { type: 'boolean', description: 'Preview changes without applying (default true)' },
+                },
+                required: ['action', 'targets'],
+            },
+        },
+    ];
+}
+const CMDB_RECON_TOOL_NAMES = new Set([
+    'cmdb_find_duplicates', 'cmdb_find_orphans', 'cmdb_find_stale', 'cmdb_reconcile',
+]);
+export async function executeCmdbReconciliationToolCall(client, name, args) {
+    if (!CMDB_RECON_TOOL_NAMES.has(name))
+        return null;
+    switch (name) {
+        case 'cmdb_find_duplicates': {
+            const ciClass = args.ci_class || 'cmdb_ci';
+            const matchFields = args.match_fields && Array.isArray(args.match_fields) && args.match_fields.length > 0
+                ? args.match_fields
+                : ['name', 'serial_number', 'ip_address'];
+            const limit = args.limit || 100;
+            const fields = ['sys_id', 'name', 'sys_class_name', ...matchFields].filter((v, i, a) => a.indexOf(v) === i);
+            const resp = await client.queryRecords({
+                table: ciClass,
+                query: 'active=true',
+                limit,
+                fields: fields.join(','),
+            });
+            // Group CIs by composite key of match fields
+            const groups = new Map();
+            for (const record of resp.records) {
+                const key = matchFields
+                    .map((f) => String(record[f] ?? '').toLowerCase().trim())
+                    .join('||');
+                // Skip records where all match fields are empty
+                const allEmpty = matchFields.every((f) => !record[f] || String(record[f]).trim() === '');
+                if (allEmpty)
+                    continue;
+                if (!groups.has(key))
+                    groups.set(key, []);
+                groups.get(key).push(record);
+            }
+            // Filter to groups with more than one CI (actual duplicates)
+            const duplicates = [];
+            for (const [key, records] of groups) {
+                if (records.length > 1) {
+                    duplicates.push({ match_key: key, count: records.length, records });
+                }
+            }
+            return {
+                ci_class: ciClass,
+                match_fields: matchFields,
+                scanned: resp.records.length,
+                duplicate_groups: duplicates.length,
+                duplicates,
+            };
+        }
+        case 'cmdb_find_orphans': {
+            const ciClass = args.ci_class || 'cmdb_ci';
+            const limit = args.limit || 50;
+            const ciResp = await client.queryRecords({
+                table: ciClass,
+                query: 'active=true',
+                limit,
+                fields: 'sys_id,name,sys_class_name,operational_status',
+            });
+            const orphans = [];
+            for (const ci of ciResp.records) {
+                const sysId = String(ci.sys_id);
+                // Check for any relationship (as parent or child)
+                const relResp = await client.queryRecords({
+                    table: 'cmdb_rel_ci',
+                    query: `parent=${sysId}^ORchild=${sysId}`,
+                    limit: 1,
+                    fields: 'sys_id',
+                });
+                if (relResp.count === 0) {
+                    orphans.push(ci);
+                }
+            }
+            return {
+                ci_class: ciClass,
+                scanned: ciResp.records.length,
+                orphan_count: orphans.length,
+                orphans,
+            };
+        }
+        case 'cmdb_find_stale': {
+            const ciClass = args.ci_class || 'cmdb_ci';
+            const daysThreshold = args.days_threshold || 90;
+            const limit = args.limit || 50;
+            const query = `sys_updated_on<javascript:gs.daysAgo(${daysThreshold})^operational_status=1^active=true`;
+            const resp = await client.queryRecords({
+                table: ciClass,
+                query,
+                limit,
+                fields: 'sys_id,name,sys_class_name,operational_status,sys_updated_on,discovery_source',
+            });
+            return {
+                ci_class: ciClass,
+                days_threshold: daysThreshold,
+                stale_count: resp.count,
+                stale_cis: resp.records,
+            };
+        }
+        case 'cmdb_reconcile': {
+            requireCmdbWrite();
+            if (!args.action)
+                throw new ServiceNowError('action is required', 'INVALID_REQUEST');
+            if (!args.targets || !Array.isArray(args.targets) || args.targets.length === 0) {
+                throw new ServiceNowError('targets must be a non-empty array of sys_ids', 'INVALID_REQUEST');
+            }
+            const validActions = ['merge_duplicates', 'retire_stale', 'remove_orphans'];
+            if (!validActions.includes(args.action)) {
+                throw new ServiceNowError(`Invalid action: "${args.action}". Must be one of: ${validActions.join(', ')}`, 'INVALID_REQUEST');
+            }
+            const dryRun = args.dry_run !== false;
+            const results = [];
+            switch (args.action) {
+                case 'merge_duplicates': {
+                    // First target is the survivor; remaining are merged into it
+                    const [survivorId, ...duplicateIds] = args.targets;
+                    if (duplicateIds.length === 0) {
+                        throw new ServiceNowError('merge_duplicates requires at least 2 targets (first is survivor)', 'INVALID_REQUEST');
+                    }
+                    if (dryRun) {
+                        results.push({ sys_id: survivorId, action: 'keep', status: 'dry_run', detail: 'Would be kept as the survivor CI' });
+                        for (const dupId of duplicateIds) {
+                            results.push({ sys_id: dupId, action: 'retire', status: 'dry_run', detail: 'Would be retired and relationships moved to survivor' });
+                        }
+                    }
+                    else {
+                        results.push({ sys_id: survivorId, action: 'keep', status: 'completed', detail: 'Kept as survivor CI' });
+                        for (const dupId of duplicateIds) {
+                            // Move relationships from duplicate to survivor
+                            const parentRels = await client.queryRecords({
+                                table: 'cmdb_rel_ci',
+                                query: `parent=${dupId}`,
+                                limit: 200,
+                                fields: 'sys_id,child,type',
+                            });
+                            for (const rel of parentRels.records) {
+                                await client.updateRecord('cmdb_rel_ci', String(rel.sys_id), { parent: survivorId });
+                            }
+                            const childRels = await client.queryRecords({
+                                table: 'cmdb_rel_ci',
+                                query: `child=${dupId}`,
+                                limit: 200,
+                                fields: 'sys_id,parent,type',
+                            });
+                            for (const rel of childRels.records) {
+                                await client.updateRecord('cmdb_rel_ci', String(rel.sys_id), { child: survivorId });
+                            }
+                            // Retire the duplicate
+                            await client.updateRecord('cmdb_ci', dupId, {
+                                operational_status: 6, // retired
+                                install_status: 7, // retired
+                            });
+                            results.push({ sys_id: dupId, action: 'retire', status: 'completed', detail: `Retired; ${parentRels.count + childRels.count} relationships moved to survivor` });
+                        }
+                    }
+                    break;
+                }
+                case 'retire_stale': {
+                    for (const sysId of args.targets) {
+                        if (dryRun) {
+                            results.push({ sys_id: sysId, action: 'retire', status: 'dry_run', detail: 'Would set operational_status=6 (retired)' });
+                        }
+                        else {
+                            await client.updateRecord('cmdb_ci', sysId, {
+                                operational_status: 6,
+                                install_status: 7,
+                            });
+                            results.push({ sys_id: sysId, action: 'retire', status: 'completed', detail: 'Set operational_status=6 (retired)' });
+                        }
+                    }
+                    break;
+                }
+                case 'remove_orphans': {
+                    for (const sysId of args.targets) {
+                        if (dryRun) {
+                            results.push({ sys_id: sysId, action: 'retire', status: 'dry_run', detail: 'Would retire orphan CI (operational_status=6)' });
+                        }
+                        else {
+                            await client.updateRecord('cmdb_ci', sysId, {
+                                operational_status: 6,
+                                install_status: 7,
+                            });
+                            results.push({ sys_id: sysId, action: 'retire', status: 'completed', detail: 'Orphan CI retired (operational_status=6)' });
+                        }
+                    }
+                    break;
+                }
+            }
+            return {
+                action: args.action,
+                dry_run: dryRun,
+                target_count: args.targets.length,
+                results,
+            };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=cmdb-reconciliation.js.map

package/dist/tools/cmdb-reconciliation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmdb-reconciliation.js","sourceRoot":"","sources":["../../src/tools/cmdb-reconciliation.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,UAAU,oCAAoC;IAClD,OAAO;QACL;YACE,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,yEAAyE;YACtF,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;oBAC7E,YAAY,EAAE;wBACZ,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,WAAW,EAAE,uFAAuF;qBACrG;oBACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;iBACxE;gBACD,QAAQ,EAAE,EAAE;aACb;SACF;QACD;YACE,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,+CAA+C;YAC5D,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;oBAC7E,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;iBAChF;gBACD,QAAQ,EAAE,EAAE;aACb;SACF;QACD;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EAAE,+EAA+E;YAC5F,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;oBAC7E,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iEAAiE,EAAE;oBAClH,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;iBAC/E;gBACD,QAAQ,EAAE,EAAE;aACb;SACF;QACD;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,yHAAyH;YACtI,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,kBAAkB,EAAE,cAAc,EAAE,gBAAgB,CAAC;wBAC5D,WAAW,EAAE,kCAAkC;qBAChD;oBACD,OAAO,EAAE;wBACP,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,WAAW,EAAE,+BAA+B;qBAC7C;oBACD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,iDAAiD,EAAE;iBAC7F;gBACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;aAChC;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,sBAAsB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,gBAAgB;CACjF,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,MAAwB,EACxB,IAAY,EACZ,IAAyB;IAEzB,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAElD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,sBAAsB,CAAC,CAAC,CAAC;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC;YAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;gBACvG,CAAC,CAAC,IAAI,CAAC,YAAY;gBACnB,CAAC,CAAC,CAAC,MAAM,EAAE,eAAe,EAAE,YAAY,CAAC,CAAC;YAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC;YAEhC,MAAM,MAAM,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,WAAW,CAAC,CAAC,MAAM,CACxE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAChC,CAAC;YAEF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;gBACrC,KAAK,EAAE,OAAO;gBACd,KAAK,EAAE,aAAa;gBACpB,KAAK;gBACL,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;aACzB,CAAC,CAAC;YAEH,6CAA6C;YAC7C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;YACxC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClC,MAAM,GAAG,GAAG,WAAW;qBACpB,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;qBAChE,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,gDAAgD;gBAChD,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBACjG,IAAI,QAAQ;oBAAE,SAAS;gBAEvB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC1C,MAAM,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;YAED,6DAA6D;YAC7D,MAAM,UAAU,GAA2D,EAAE,CAAC;YAC9E,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,EAAE,CAAC;gBACpC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC;YAED,OAAO;gBACL,QAAQ,EAAE,OAAO;gBACjB,YAAY,EAAE,WAAW;gBACzB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;gBAC5B,gBAAgB,EAAE,UAAU,CAAC,MAAM;gBACnC,UAAU;aACX,CAAC;QACJ,CAAC;QAED,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC;YAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAE/B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;gBACvC,KAAK,EAAE,OAAO;gBACd,KAAK,EAAE,aAAa;gBACpB,KAAK;gBACL,MAAM,EAAE,+CAA+C;aACxD,CAAC,CAAC;YAEH,MAAM,OAAO,GAAU,EAAE,CAAC;YAC1B,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBAChC,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;gBAChC,kDAAkD;gBAClD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;oBACxC,KAAK,EAAE,aAAa;oBACpB,KAAK,EAAE,UAAU,KAAK,YAAY,KAAK,EAAE;oBACzC,KAAK,EAAE,CAAC;oBACR,MAAM,EAAE,QAAQ;iBACjB,CAAC,CAAC;gBACH,IAAI,OAAO,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;oBACxB,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACnB,CAAC;YACH,CAAC;YAED,OAAO;gBACL,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;gBAC9B,YAAY,EAAE,OAAO,CAAC,MAAM;gBAC5B,OAAO;aACR,CAAC;QACJ,CAAC;QAED,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC;YAC3C,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAE/B,MAAM,KAAK,GAAG,wCAAwC,aAAa,oCAAoC,CAAC;YAExG,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;gBACrC,KAAK,EAAE,OAAO;gBACd,KAAK;gBACL,KAAK;gBACL,MAAM,EAAE,+EAA+E;aACxF,CAAC,CAAC;YAEH,OAAO;gBACL,QAAQ,EAAE,OAAO;gBACjB,cAAc,EAAE,aAAa;gBAC7B,WAAW,EAAE,IAAI,CAAC,KAAK;gBACvB,SAAS,EAAE,IAAI,CAAC,OAAO;aACxB,CAAC;QACJ,CAAC;QAED,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,gBAAgB,EAAE,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,eAAe,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAC;YACrF,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/E,MAAM,IAAI,eAAe,CAAC,8CAA8C,EAAE,iBAAiB,CAAC,CAAC;YAC/F,CAAC;YAED,MAAM,YAAY,GAAG,CAAC,kBAAkB,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC;YAC5E,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAI,eAAe,CACvB,oBAAoB,IAAI,CAAC,MAAM,sBAAsB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC9E,iBAAiB,CAClB,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC;YACtC,MAAM,OAAO,GAAyE,EAAE,CAAC;YAEzF,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;gBACpB,KAAK,kBAAkB,CAAC,CAAC,CAAC;oBACxB,6DAA6D;oBAC7D,MAAM,CAAC,UAAU,EAAE,GAAG,YAAY,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;oBACnD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBAC9B,MAAM,IAAI,eAAe,CAAC,kEAAkE,EAAE,iBAAiB,CAAC,CAAC;oBACnH,CAAC;oBAED,IAAI,MAAM,EAAE,CAAC;wBACX,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,kCAAkC,EAAE,CAAC,CAAC;wBACpH,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;4BACjC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,sDAAsD,EAAE,CAAC,CAAC;wBACvI,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAC;wBACzG,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;4BACjC,gDAAgD;4BAChD,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;gCAC3C,KAAK,EAAE,aAAa;gCACpB,KAAK,EAAE,UAAU,KAAK,EAAE;gCACxB,KAAK,EAAE,GAAG;gCACV,MAAM,EAAE,mBAAmB;6BAC5B,CAAC,CAAC;4BACH,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;gCACrC,MAAM,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;4BACvF,CAAC;4BAED,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;gCAC1C,KAAK,EAAE,aAAa;gCACpB,KAAK,EAAE,SAAS,KAAK,EAAE;gCACvB,KAAK,EAAE,GAAG;gCACV,MAAM,EAAE,oBAAoB;6BAC7B,CAAC,CAAC;4BACH,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;gCACpC,MAAM,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;4BACtF,CAAC;4BAED,uBAAuB;4BACvB,MAAM,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE;gCAC1C,kBAAkB,EAAE,CAAC,EAAE,UAAU;gCACjC,cAAc,EAAE,CAAC,EAAM,UAAU;6BAClC,CAAC,CAAC;4BACH,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,UAAU,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,kCAAkC,EAAE,CAAC,CAAC;wBACnK,CAAC;oBACH,CAAC;oBACD,MAAM;gBACR,CAAC;gBAED,KAAK,cAAc,CAAC,CAAC,CAAC;oBACpB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;wBACjC,IAAI,MAAM,EAAE,CAAC;4BACX,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,0CAA0C,EAAE,CAAC,CAAC;wBAC3H,CAAC;6BAAM,CAAC;4BACN,MAAM,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE;gCAC1C,kBAAkB,EAAE,CAAC;gCACrB,cAAc,EAAE,CAAC;6BAClB,CAAC,CAAC;4BACH,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,oCAAoC,EAAE,CAAC,CAAC;wBACvH,CAAC;oBACH,CAAC;oBACD,MAAM;gBACR,CAAC;gBAED,KAAK,gBAAgB,CAAC,CAAC,CAAC;oBACtB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;wBACjC,IAAI,MAAM,EAAE,CAAC;4BACX,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,+CAA+C,EAAE,CAAC,CAAC;wBAChI,CAAC;6BAAM,CAAC;4BACN,MAAM,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE;gCAC1C,kBAAkB,EAAE,CAAC;gCACrB,cAAc,EAAE,CAAC;6BAClB,CAAC,CAAC;4BACH,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,0CAA0C,EAAE,CAAC,CAAC;wBAC7H,CAAC;oBACH,CAAC;oBACD,MAAM;gBACR,CAAC;YACH,CAAC;YAED,OAAO;gBACL,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,MAAM;gBACf,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;gBACjC,OAAO;aACR,CAAC;QACJ,CAAC;QAED;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/tools/discovery.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Dynamic Schema Discovery tool — reads table schema at runtime and generates
+ * ad-hoc CRUD tools for any ServiceNow table.
+ *
+ * Tools:
+ *   discover_table — Discover a table's schema and register dynamic CRUD tools
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getDiscoveryToolDefinitions(): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            table: {
+                type: string;
+                description: string;
+            };
+            operations: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+            };
+        };
+        required: string[];
+    };
+}[];
+export declare function executeDiscoveryToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+/** Execute a dynamically discovered tool. */
+export declare function executeDynamicToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/tools/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAKhE,wBAAgB,2BAA2B;;;;;;;;;;;;;;;;;;;;;IAuB1C;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,CA2Fd;AAED,6CAA6C;AAC7C,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAwDd"}

package/dist/tools/discovery.js

@@ -0,0 +1,168 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { schemaCache } from './schema-cache.js';
+import { requireWrite } from '../utils/permissions.js';
+export function getDiscoveryToolDefinitions() {
+    return [
+        {
+            name: 'discover_table',
+            description: 'Discover a ServiceNow table schema and register dynamic CRUD tools for it. ' +
+                'After discovery, new tools become available: dynamic_query_<table>, dynamic_get_<table>, ' +
+                'dynamic_create_<table>, dynamic_update_<table>, dynamic_delete_<table>. ' +
+                'Schemas are cached for 30 minutes.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    table: { type: 'string', description: 'Table name to discover (e.g., "u_custom_table")' },
+                    operations: {
+                        type: 'array',
+                        description: 'Operations to enable: query, get, create, update, delete. Default: all.',
+                        items: { type: 'string', enum: ['query', 'get', 'create', 'update', 'delete'] },
+                    },
+                },
+                required: ['table'],
+            },
+        },
+    ];
+}
+export async function executeDiscoveryToolCall(client, name, args) {
+    if (name !== 'discover_table')
+        return null;
+    const table = args.table;
+    if (!table || typeof table !== 'string') {
+        throw new ServiceNowError('table is required', 'INVALID_REQUEST');
+    }
+    // Check cache first
+    const cached = schemaCache.get(table);
+    if (cached) {
+        return {
+            table,
+            source: 'cache',
+            columns: cached.columns.length,
+            available_tools: cached.generatedToolNames,
+            cache_expires_in_minutes: Math.round((cached.ttlMs - (Date.now() - cached.cachedAt)) / 60000),
+        };
+    }
+    // Query sys_dictionary for detailed schema
+    const dictResult = await client.queryRecords({
+        table: 'sys_dictionary',
+        query: `name=${table}^elementISNOTEMPTY^internal_type!=collection`,
+        fields: 'element,internal_type,column_label,max_length,mandatory,reference,read_only,default_value',
+        limit: 200,
+    });
+    if (dictResult.count === 0) {
+        // Fallback: try to query the table directly to verify it exists
+        try {
+            const probe = await client.queryRecords({ table, limit: 1 });
+            if (probe.count === 0 && probe.records.length === 0) {
+                throw new ServiceNowError(`Table "${table}" not found or has no schema`, 'NOT_FOUND');
+            }
+            // Table exists but no sys_dictionary entries — build minimal schema from record keys
+            const record = probe.records[0] || {};
+            const columns = Object.keys(record).map(key => ({
+                element: key,
+                internal_type: 'string',
+                label: key,
+                max_length: 255,
+                mandatory: false,
+                read_only: key.startsWith('sys_'),
+                default_value: undefined,
+            }));
+            const toolNames = buildToolNames(table, args.operations);
+            schemaCache.set(table, columns, toolNames);
+            return {
+                table,
+                source: 'record_probe',
+                columns: columns.length,
+                available_tools: toolNames,
+                note: 'Schema derived from record structure (sys_dictionary unavailable)',
+            };
+        }
+        catch (e) {
+            if (e instanceof ServiceNowError)
+                throw e;
+            throw new ServiceNowError(`Table "${table}" not found`, 'NOT_FOUND');
+        }
+    }
+    // Parse sys_dictionary results into ColumnSchema
+    const columns = dictResult.records.map((r) => ({
+        element: r.element,
+        internal_type: r.internal_type || 'string',
+        label: r.column_label || r.element,
+        max_length: parseInt(r.max_length) || 255,
+        mandatory: r.mandatory === 'true' || r.mandatory === true,
+        reference: r.reference || undefined,
+        read_only: r.read_only === 'true' || r.read_only === true,
+        default_value: r.default_value || undefined,
+    }));
+    const toolNames = buildToolNames(table, args.operations);
+    schemaCache.set(table, columns, toolNames);
+    return {
+        table,
+        source: 'sys_dictionary',
+        columns: columns.length,
+        column_details: columns.slice(0, 20).map(c => ({
+            name: c.element,
+            type: c.internal_type,
+            label: c.label,
+            mandatory: c.mandatory,
+            reference: c.reference,
+        })),
+        available_tools: toolNames,
+    };
+}
+/** Execute a dynamically discovered tool. */
+export async function executeDynamicToolCall(client, name, args) {
+    // Check if this is a dynamic tool
+    const match = name.match(/^dynamic_(query|get|create|update|delete)_(.+)$/);
+    if (!match)
+        return null;
+    const operation = match[1];
+    const table = match[2];
+    // Verify schema is cached
+    const cached = schemaCache.get(table);
+    if (!cached) {
+        throw new ServiceNowError(`Table "${table}" schema not cached. Run discover_table first.`, 'SCHEMA_NOT_CACHED');
+    }
+    switch (operation) {
+        case 'query': {
+            const limit = Math.min(args.limit || 20, 200);
+            return client.queryRecords({
+                table,
+                query: args.query,
+                fields: args.fields,
+                limit,
+                orderBy: args.orderBy,
+            });
+        }
+        case 'get': {
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            return client.getRecord(table, args.sys_id, args.fields);
+        }
+        case 'create': {
+            requireWrite();
+            const { sys_id: _sysId, ...fields } = args; // eslint-disable-line @typescript-eslint/no-unused-vars
+            return client.createRecord(table, fields);
+        }
+        case 'update': {
+            requireWrite();
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            const { sys_id, ...fields } = args;
+            return client.updateRecord(table, sys_id, fields);
+        }
+        case 'delete': {
+            requireWrite();
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            return client.deleteRecord(table, args.sys_id);
+        }
+        default:
+            return null;
+    }
+}
+function buildToolNames(table, operations) {
+    const ops = operations || ['query', 'get', 'create', 'update', 'delete'];
+    return ops.map(op => `dynamic_${op}_${table}`);
+}
+//# sourceMappingURL=discovery.js.map

package/dist/tools/discovery.js.map

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

package/dist/tools/fluent.d.ts

@@ -1,14 +1,3 @@
-/**
- * Fluent / GlideQuery-style tools — modern query interface for ServiceNow.
- *
- * Provides:
- *   - fluent_query: GlideQuery-style chained query builder (select, where, aggregate)
- *   - batch_request: Execute multiple API operations in a single HTTP call
- *   - execute_script: Run server-side GlideQuery/GlideRecord scripts via Background Script
- *
- * These tools give AI agents a modern, expressive way to interact with ServiceNow
- * that mirrors the GlideQuery API developers use in the platform.
- */
 import type { ServiceNowClient } from '../servicenow/client.js';
 export declare function getFluentToolDefinitions(): ({
     name: string;
@@ -75,6 +64,10 @@ export declare function getFluentToolDefinitions(): ({
             operations?: undefined;
             script?: undefined;
             scope?: undefined;
+            topic?: undefined;
+            name?: undefined;
+            template?: undefined;
+            directory?: undefined;
         };
         required: string[];
     };
@@ -125,6 +118,10 @@ export declare function getFluentToolDefinitions(): ({
             displayValue?: undefined;
             script?: undefined;
             scope?: undefined;
+            topic?: undefined;
+            name?: undefined;
+            template?: undefined;
+            directory?: undefined;
         };
         required: string[];
     };
@@ -153,9 +150,106 @@ export declare function getFluentToolDefinitions(): ({
             limit?: undefined;
             displayValue?: undefined;
             operations?: undefined;
+            topic?: undefined;
+            name?: undefined;
+            template?: undefined;
+            directory?: undefined;
         };
         required: string[];
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            topic: {
+                type: string;
+                description: string;
+            };
+            table?: undefined;
+            where?: undefined;
+            orWhere?: undefined;
+            select?: undefined;
+            aggregate?: undefined;
+            aggregateField?: undefined;
+            groupBy?: undefined;
+            orderBy?: undefined;
+            limit?: undefined;
+            displayValue?: undefined;
+            operations?: undefined;
+            script?: undefined;
+            scope?: undefined;
+            name?: undefined;
+            template?: undefined;
+            directory?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            template: {
+                type: string;
+                description: string;
+            };
+            directory: {
+                type: string;
+                description: string;
+            };
+            table?: undefined;
+            where?: undefined;
+            orWhere?: undefined;
+            select?: undefined;
+            aggregate?: undefined;
+            aggregateField?: undefined;
+            groupBy?: undefined;
+            orderBy?: undefined;
+            limit?: undefined;
+            displayValue?: undefined;
+            operations?: undefined;
+            script?: undefined;
+            scope?: undefined;
+            topic?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            directory: {
+                type: string;
+                description: string;
+            };
+            table?: undefined;
+            where?: undefined;
+            orWhere?: undefined;
+            select?: undefined;
+            aggregate?: undefined;
+            aggregateField?: undefined;
+            groupBy?: undefined;
+            orderBy?: undefined;
+            limit?: undefined;
+            displayValue?: undefined;
+            operations?: undefined;
+            script?: undefined;
+            scope?: undefined;
+            topic?: undefined;
+            name?: undefined;
+            template?: undefined;
+        };
+        required: never[];
+    };
 })[];
 export declare function executeFluentToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
 //# sourceMappingURL=fluent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fluent.d.ts","sourceRoot":"","sources":["../../src/tools/fluent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,wBAAgB,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAsHvC;AAgED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAyHd"}
+{"version":3,"file":"fluent.d.ts","sourceRoot":"","sources":["../../src/tools/fluent.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAkBhE,wBAAgB,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA+KvC;AAgED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CA6Jd"}