snow-flow 8.39.2 → 8.39.3

package/dist/mcp/servicenow-mcp-unified/tools/automation/snow_get_inbound_http_logs.js

@@ -0,0 +1,233 @@
+"use strict";
+/**
+ * snow_get_inbound_http_logs - View incoming HTTP request logs
+ *
+ * Retrieve inbound REST API transaction logs to monitor
+ * API usage, performance, and troubleshoot incoming requests.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.author = exports.version = exports.toolDefinition = void 0;
+exports.execute = execute;
+const auth_js_1 = require("../../shared/auth.js");
+const error_handler_js_1 = require("../../shared/error-handler.js");
+exports.toolDefinition = {
+    name: 'snow_get_inbound_http_logs',
+    description: 'Retrieve inbound REST API transaction logs for monitoring API usage and debugging incoming requests',
+    // Metadata for tool discovery (not sent to LLM)
+    category: 'automation',
+    subcategory: 'monitoring',
+    use_cases: ['api', 'rest', 'monitoring', 'debugging', 'http', 'transactions'],
+    complexity: 'beginner',
+    frequency: 'high',
+    // Permission enforcement
+    // Classification: READ - Get operation - retrieves data
+    permission: 'read',
+    allowedRoles: ['developer', 'stakeholder', 'admin'],
+    inputSchema: {
+        type: 'object',
+        properties: {
+            status: {
+                type: 'string',
+                enum: ['success', 'error', 'all'],
+                description: 'Filter by response status (success = 2xx, error = 4xx/5xx)',
+                default: 'all'
+            },
+            url_path: {
+                type: 'string',
+                description: 'Filter by request URL path (partial match)'
+            },
+            http_method: {
+                type: 'string',
+                enum: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'all'],
+                description: 'Filter by HTTP method',
+                default: 'all'
+            },
+            user: {
+                type: 'string',
+                description: 'Filter by user who made the request'
+            },
+            source_ip: {
+                type: 'string',
+                description: 'Filter by source IP address'
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of log entries to return',
+                default: 50,
+                minimum: 1,
+                maximum: 500
+            },
+            since: {
+                type: 'string',
+                description: 'Get logs since this timestamp (ISO 8601 or relative like "1h", "30m", "7d")'
+            },
+            min_response_time: {
+                type: 'number',
+                description: 'Only show requests slower than this (milliseconds) - useful for performance debugging'
+            }
+        }
+    }
+};
+async function execute(args, context) {
+    var status = args.status || 'all';
+    var url_path = args.url_path;
+    var http_method = args.http_method || 'all';
+    var user = args.user;
+    var source_ip = args.source_ip;
+    var limit = args.limit || 50;
+    var since = args.since;
+    var min_response_time = args.min_response_time;
+    try {
+        var client = await (0, auth_js_1.getAuthenticatedClient)(context);
+        // Build query
+        var queryParts = [];
+        // Status filter
+        if (status === 'success') {
+            queryParts.push('status_code>=200^status_code<300');
+        }
+        else if (status === 'error') {
+            queryParts.push('status_code>=400');
+        }
+        // URL path filter
+        if (url_path) {
+            queryParts.push('urlLIKE' + url_path);
+        }
+        // HTTP method filter
+        if (http_method !== 'all') {
+            queryParts.push('http_method=' + http_method);
+        }
+        // User filter
+        if (user) {
+            queryParts.push('user.user_nameLIKE' + user);
+        }
+        // Source IP filter
+        if (source_ip) {
+            queryParts.push('client_ip=' + source_ip);
+        }
+        // Time range filter
+        if (since) {
+            var sinceTimestamp = parseRelativeTime(since);
+            queryParts.push('sys_created_on>' + sinceTimestamp);
+        }
+        // Response time filter (for slow query analysis)
+        if (min_response_time) {
+            queryParts.push('response_time>' + min_response_time);
+        }
+        var query = queryParts.join('^');
+        // Get inbound transaction logs from syslog_transaction
+        var response = await client.get('/api/now/table/syslog_transaction', {
+            params: {
+                sysparm_query: query + '^ORDERBYDESCsys_created_on',
+                sysparm_limit: limit,
+                sysparm_fields: 'sys_id,sys_created_on,url,http_method,status_code,response_time,client_ip,user,session_id,source'
+            }
+        });
+        var logs = response.data.result.map(function (log) {
+            return {
+                sys_id: log.sys_id,
+                timestamp: log.sys_created_on,
+                url: log.url,
+                http_method: log.http_method,
+                status_code: log.status_code,
+                response_time_ms: log.response_time,
+                client_ip: log.client_ip,
+                user: log.user,
+                session_id: log.session_id,
+                source: log.source
+            };
+        });
+        // Calculate statistics
+        var stats = {
+            total: logs.length,
+            success: 0,
+            client_error: 0,
+            server_error: 0,
+            avg_response_time_ms: 0,
+            max_response_time_ms: 0,
+            p95_response_time_ms: 0
+        };
+        var responseTimes = [];
+        logs.forEach(function (log) {
+            var statusCode = parseInt(log.status_code) || 0;
+            if (statusCode >= 200 && statusCode < 300) {
+                stats.success++;
+            }
+            else if (statusCode >= 400 && statusCode < 500) {
+                stats.client_error++;
+            }
+            else if (statusCode >= 500) {
+                stats.server_error++;
+            }
+            var responseTime = parseInt(log.response_time_ms) || 0;
+            responseTimes.push(responseTime);
+        });
+        if (responseTimes.length > 0) {
+            responseTimes.sort(function (a, b) { return a - b; });
+            var sum = responseTimes.reduce(function (a, b) { return a + b; }, 0);
+            stats.avg_response_time_ms = Math.round(sum / responseTimes.length);
+            stats.max_response_time_ms = responseTimes[responseTimes.length - 1];
+            var p95Index = Math.floor(responseTimes.length * 0.95);
+            stats.p95_response_time_ms = responseTimes[p95Index] || stats.max_response_time_ms;
+        }
+        // Group by endpoint
+        var byEndpoint = {};
+        logs.forEach(function (log) {
+            var path = log.url || 'unknown';
+            // Simplify path by removing query params and IDs
+            path = path.split('?')[0];
+            path = path.replace(/\/[a-f0-9]{32}/gi, '/{sys_id}');
+            byEndpoint[path] = (byEndpoint[path] || 0) + 1;
+        });
+        // Group by HTTP method
+        var byMethod = {};
+        logs.forEach(function (log) {
+            var method = log.http_method || 'unknown';
+            byMethod[method] = (byMethod[method] || 0) + 1;
+        });
+        // Top users
+        var byUser = {};
+        logs.forEach(function (log) {
+            var userName = log.user || 'anonymous';
+            byUser[userName] = (byUser[userName] || 0) + 1;
+        });
+        return (0, error_handler_js_1.createSuccessResult)({
+            logs: logs,
+            count: logs.length,
+            statistics: stats,
+            by_endpoint: byEndpoint,
+            by_method: byMethod,
+            by_user: byUser,
+            filters: { status: status, url_path: url_path, http_method: http_method, user: user, source_ip: source_ip, since: since, min_response_time: min_response_time }
+        });
+    }
+    catch (error) {
+        return (0, error_handler_js_1.createErrorResult)(error.message);
+    }
+}
+function parseRelativeTime(relative) {
+    var now = new Date();
+    var match = relative.match(/^(\d+)([mhd])$/);
+    if (!match) {
+        // Assume it's an absolute timestamp
+        return relative;
+    }
+    var value = parseInt(match[1]);
+    var unit = match[2];
+    var milliseconds = 0;
+    switch (unit) {
+        case 'm':
+            milliseconds = value * 60 * 1000;
+            break;
+        case 'h':
+            milliseconds = value * 60 * 60 * 1000;
+            break;
+        case 'd':
+            milliseconds = value * 24 * 60 * 60 * 1000;
+            break;
+    }
+    var sinceDate = new Date(now.getTime() - milliseconds);
+    return sinceDate.toISOString();
+}
+exports.version = '1.0.0';
+exports.author = 'Snow-Flow Team';
+//# sourceMappingURL=snow_get_inbound_http_logs.js.map

package/dist/mcp/servicenow-mcp-unified/tools/automation/snow_get_inbound_http_logs.js.map

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

package/dist/mcp/servicenow-mcp-unified/tools/automation/snow_get_outbound_http_logs.d.ts

@@ -0,0 +1,12 @@
+/**
+ * snow_get_outbound_http_logs - View outgoing HTTP request logs
+ *
+ * Retrieve outbound HTTP request logs to monitor and debug
+ * REST/SOAP integrations, webhooks, and external API calls.
+ */
+import { MCPToolDefinition, ServiceNowContext, ToolResult } from '../../shared/types.js';
+export declare const toolDefinition: MCPToolDefinition;
+export declare function execute(args: any, context: ServiceNowContext): Promise<ToolResult>;
+export declare const version = "1.0.0";
+export declare const author = "Snow-Flow Team";
+//# sourceMappingURL=snow_get_outbound_http_logs.d.ts.map

package/dist/mcp/servicenow-mcp-unified/tools/automation/snow_get_outbound_http_logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snow_get_outbound_http_logs.d.ts","sourceRoot":"","sources":["../../../../../src/mcp/servicenow-mcp-unified/tools/automation/snow_get_outbound_http_logs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIzF,eAAO,MAAM,cAAc,EAAE,iBAuD5B,CAAC;AAEF,wBAAsB,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAyIxF;AAyBD,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,MAAM,mBAAmB,CAAC"}

package/dist/mcp/servicenow-mcp-unified/tools/automation/snow_get_outbound_http_logs.js

@@ -0,0 +1,218 @@
+"use strict";
+/**
+ * snow_get_outbound_http_logs - View outgoing HTTP request logs
+ *
+ * Retrieve outbound HTTP request logs to monitor and debug
+ * REST/SOAP integrations, webhooks, and external API calls.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.author = exports.version = exports.toolDefinition = void 0;
+exports.execute = execute;
+const auth_js_1 = require("../../shared/auth.js");
+const error_handler_js_1 = require("../../shared/error-handler.js");
+exports.toolDefinition = {
+    name: 'snow_get_outbound_http_logs',
+    description: 'Retrieve outbound HTTP request logs for monitoring REST/SOAP integrations and external API calls',
+    // Metadata for tool discovery (not sent to LLM)
+    category: 'automation',
+    subcategory: 'monitoring',
+    use_cases: ['integration', 'rest', 'soap', 'monitoring', 'debugging', 'http'],
+    complexity: 'beginner',
+    frequency: 'high',
+    // Permission enforcement
+    // Classification: READ - Get operation - retrieves data
+    permission: 'read',
+    allowedRoles: ['developer', 'stakeholder', 'admin'],
+    inputSchema: {
+        type: 'object',
+        properties: {
+            status: {
+                type: 'string',
+                enum: ['success', 'error', 'all'],
+                description: 'Filter by response status (success = 2xx, error = 4xx/5xx)',
+                default: 'all'
+            },
+            endpoint: {
+                type: 'string',
+                description: 'Filter by target endpoint URL (partial match)'
+            },
+            rest_message: {
+                type: 'string',
+                description: 'Filter by REST Message name'
+            },
+            http_method: {
+                type: 'string',
+                enum: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'all'],
+                description: 'Filter by HTTP method',
+                default: 'all'
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of log entries to return',
+                default: 50,
+                minimum: 1,
+                maximum: 500
+            },
+            since: {
+                type: 'string',
+                description: 'Get logs since this timestamp (ISO 8601 or relative like "1h", "30m", "7d")'
+            },
+            include_payload: {
+                type: 'boolean',
+                description: 'Include request/response body in output (can be large)',
+                default: false
+            }
+        }
+    }
+};
+async function execute(args, context) {
+    var status = args.status || 'all';
+    var endpoint = args.endpoint;
+    var rest_message = args.rest_message;
+    var http_method = args.http_method || 'all';
+    var limit = args.limit || 50;
+    var since = args.since;
+    var include_payload = args.include_payload || false;
+    try {
+        var client = await (0, auth_js_1.getAuthenticatedClient)(context);
+        // Build query
+        var queryParts = [];
+        // Status filter (based on HTTP status code)
+        if (status === 'success') {
+            queryParts.push('http_status>=200^http_status<300');
+        }
+        else if (status === 'error') {
+            queryParts.push('http_status>=400');
+        }
+        // Endpoint filter
+        if (endpoint) {
+            queryParts.push('urlLIKE' + endpoint);
+        }
+        // REST Message filter
+        if (rest_message) {
+            queryParts.push('rest_message.nameLIKE' + rest_message);
+        }
+        // HTTP method filter
+        if (http_method !== 'all') {
+            queryParts.push('http_method=' + http_method);
+        }
+        // Time range filter
+        if (since) {
+            var sinceTimestamp = parseRelativeTime(since);
+            queryParts.push('sys_created_on>' + sinceTimestamp);
+        }
+        var query = queryParts.join('^');
+        // Build fields list
+        var fields = 'sys_id,sys_created_on,url,http_method,http_status,response_time,rest_message,source_table,source_sys_id,error_message';
+        if (include_payload) {
+            fields += ',request_headers,request_body,response_headers,response_body';
+        }
+        // Get outbound HTTP logs
+        var response = await client.get('/api/now/table/sys_outbound_http_log', {
+            params: {
+                sysparm_query: query + '^ORDERBYDESCsys_created_on',
+                sysparm_limit: limit,
+                sysparm_fields: fields
+            }
+        });
+        var logs = response.data.result.map(function (log) {
+            var record = {
+                sys_id: log.sys_id,
+                timestamp: log.sys_created_on,
+                url: log.url,
+                http_method: log.http_method,
+                http_status: log.http_status,
+                response_time_ms: log.response_time,
+                rest_message: log.rest_message,
+                source_table: log.source_table,
+                source_sys_id: log.source_sys_id,
+                error: log.error_message || null
+            };
+            if (include_payload) {
+                record.request = {
+                    headers: log.request_headers,
+                    body: log.request_body
+                };
+                record.response = {
+                    headers: log.response_headers,
+                    body: log.response_body
+                };
+            }
+            return record;
+        });
+        // Calculate statistics
+        var stats = {
+            total: logs.length,
+            success: 0,
+            client_error: 0,
+            server_error: 0,
+            avg_response_time_ms: 0
+        };
+        var totalResponseTime = 0;
+        logs.forEach(function (log) {
+            var statusCode = parseInt(log.http_status) || 0;
+            if (statusCode >= 200 && statusCode < 300) {
+                stats.success++;
+            }
+            else if (statusCode >= 400 && statusCode < 500) {
+                stats.client_error++;
+            }
+            else if (statusCode >= 500) {
+                stats.server_error++;
+            }
+            totalResponseTime += parseInt(log.response_time_ms) || 0;
+        });
+        if (logs.length > 0) {
+            stats.avg_response_time_ms = Math.round(totalResponseTime / logs.length);
+        }
+        // Group by endpoint
+        var byEndpoint = {};
+        logs.forEach(function (log) {
+            try {
+                var url = new URL(log.url);
+                var host = url.hostname;
+                byEndpoint[host] = (byEndpoint[host] || 0) + 1;
+            }
+            catch (e) {
+                byEndpoint['unknown'] = (byEndpoint['unknown'] || 0) + 1;
+            }
+        });
+        return (0, error_handler_js_1.createSuccessResult)({
+            logs: logs,
+            count: logs.length,
+            statistics: stats,
+            by_endpoint: byEndpoint,
+            filters: { status: status, endpoint: endpoint, rest_message: rest_message, http_method: http_method, since: since }
+        });
+    }
+    catch (error) {
+        return (0, error_handler_js_1.createErrorResult)(error.message);
+    }
+}
+function parseRelativeTime(relative) {
+    var now = new Date();
+    var match = relative.match(/^(\d+)([mhd])$/);
+    if (!match) {
+        // Assume it's an absolute timestamp
+        return relative;
+    }
+    var value = parseInt(match[1]);
+    var unit = match[2];
+    var milliseconds = 0;
+    switch (unit) {
+        case 'm':
+            milliseconds = value * 60 * 1000;
+            break;
+        case 'h':
+            milliseconds = value * 60 * 60 * 1000;
+            break;
+        case 'd':
+            milliseconds = value * 24 * 60 * 60 * 1000;
+            break;
+    }
+    var sinceDate = new Date(now.getTime() - milliseconds);
+    return sinceDate.toISOString();
+}
+exports.version = '1.0.0';
+exports.author = 'Snow-Flow Team';
+//# sourceMappingURL=snow_get_outbound_http_logs.js.map

package/dist/mcp/servicenow-mcp-unified/tools/automation/snow_get_outbound_http_logs.js.map

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

package/dist/mcp/servicenow-mcp-unified/tools/automation/snow_get_scheduled_job_logs.d.ts

@@ -0,0 +1,12 @@
+/**
+ * snow_get_scheduled_job_logs - View Scheduled Job execution history
+ *
+ * Retrieve scheduled job execution logs to monitor job runs,
+ * identify failures, and track job performance.
+ */
+import { MCPToolDefinition, ServiceNowContext, ToolResult } from '../../shared/types.js';
+export declare const toolDefinition: MCPToolDefinition;
+export declare function execute(args: any, context: ServiceNowContext): Promise<ToolResult>;
+export declare const version = "1.0.0";
+export declare const author = "Snow-Flow Team";
+//# sourceMappingURL=snow_get_scheduled_job_logs.d.ts.map

package/dist/mcp/servicenow-mcp-unified/tools/automation/snow_get_scheduled_job_logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snow_get_scheduled_job_logs.d.ts","sourceRoot":"","sources":["../../../../../src/mcp/servicenow-mcp-unified/tools/automation/snow_get_scheduled_job_logs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIzF,eAAO,MAAM,cAAc,EAAE,iBA6D5B,CAAC;AAEF,wBAAsB,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CA2KxF;AA4CD,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,MAAM,mBAAmB,CAAC"}