snow-flow 8.39.2 → 8.39.3

package/dist/mcp/servicenow-mcp-unified/tools/integration/snow_create_connection_alias.js

@@ -0,0 +1,234 @@
+"use strict";
+/**
+ * snow_create_connection_alias - Create Connection & Credential Aliases
+ *
+ * Create connection aliases for IntegrationHub and Flow Designer
+ * to securely reference external system credentials.
+ */
+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_create_connection_alias',
+    description: 'Create connection alias for IntegrationHub/Flow Designer to reference external credentials',
+    category: 'integration',
+    subcategory: 'credentials',
+    use_cases: ['integration-hub', 'flow-designer', 'credentials', 'connections'],
+    complexity: 'intermediate',
+    frequency: 'medium',
+    permission: 'write',
+    allowedRoles: ['developer', 'admin'],
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'Connection alias name (e.g., "Jira Production", "Azure DevOps")'
+            },
+            connection_type: {
+                type: 'string',
+                enum: ['http', 'jdbc', 'ldap', 'ssh', 'custom'],
+                description: 'Type of connection',
+                default: 'http'
+            },
+            configuration_template: {
+                type: 'string',
+                description: 'sys_id of the connection configuration template (e.g., for specific Spoke)'
+            },
+            credential_alias: {
+                type: 'string',
+                description: 'sys_id of credential alias to use (if already exists)'
+            },
+            active: {
+                type: 'boolean',
+                description: 'Whether the alias is active',
+                default: true
+            },
+            http_connection: {
+                type: 'object',
+                description: 'HTTP connection details (for http type)',
+                properties: {
+                    base_url: {
+                        type: 'string',
+                        description: 'Base URL of the external system'
+                    },
+                    default_headers: {
+                        type: 'object',
+                        description: 'Default headers to send'
+                    },
+                    use_mutual_auth: {
+                        type: 'boolean',
+                        description: 'Enable mutual TLS authentication'
+                    },
+                    mid_server: {
+                        type: 'string',
+                        description: 'MID Server to use for connection'
+                    }
+                }
+            },
+            retry_policy: {
+                type: 'object',
+                description: 'Retry policy for failed connections',
+                properties: {
+                    max_retries: {
+                        type: 'number',
+                        description: 'Maximum number of retries',
+                        default: 3
+                    },
+                    retry_interval_seconds: {
+                        type: 'number',
+                        description: 'Seconds between retries',
+                        default: 5
+                    }
+                }
+            }
+        },
+        required: ['name']
+    }
+};
+async function execute(args, context) {
+    var name = args.name;
+    var connection_type = args.connection_type || 'http';
+    var configuration_template = args.configuration_template || '';
+    var credential_alias = args.credential_alias || '';
+    var active = args.active !== false;
+    var http_connection = args.http_connection || {};
+    var retry_policy = args.retry_policy || {};
+    try {
+        var client = await (0, auth_js_1.getAuthenticatedClient)(context);
+        var usedBackgroundScript = false;
+        // Create the connection alias record
+        var aliasData = {
+            name: name,
+            type: connection_type,
+            active: active
+        };
+        if (configuration_template) {
+            aliasData.configuration_template = configuration_template;
+        }
+        if (credential_alias) {
+            aliasData.credential = credential_alias;
+        }
+        var aliasResponse;
+        try {
+            aliasResponse = await client.post('/api/now/table/sys_alias', aliasData);
+        }
+        catch (tableError) {
+            if (tableError.response?.status === 403) {
+                usedBackgroundScript = true;
+                var script = `
+          var gr = new GlideRecord('sys_alias');
+          gr.initialize();
+          gr.name = ${JSON.stringify(name)};
+          gr.type = ${JSON.stringify(connection_type)};
+          gr.active = ${active};
+          ${configuration_template ? `gr.configuration_template = ${JSON.stringify(configuration_template)};` : ''}
+          ${credential_alias ? `gr.credential = ${JSON.stringify(credential_alias)};` : ''}
+          var sysId = gr.insert();
+
+          if (sysId) {
+            gs.print(JSON.stringify({
+              sys_id: sysId,
+              name: gr.name.toString(),
+              type: gr.type.toString()
+            }));
+          } else {
+            gs.error('Failed to create connection alias');
+          }
+        `;
+                var scriptResponse = await client.post('/api/now/table/sys_script_execution', {
+                    script: script,
+                    description: 'Create connection alias: ' + name
+                });
+                var output = scriptResponse.data.result?.output || '';
+                var match = output.match(/\{[^}]+\}/);
+                if (match) {
+                    aliasResponse = { data: { result: JSON.parse(match[0]) } };
+                }
+                else {
+                    throw new Error('Failed to create connection alias via background script');
+                }
+            }
+            else {
+                throw tableError;
+            }
+        }
+        var alias = aliasResponse.data.result;
+        // If HTTP connection details provided, create HTTP connection record
+        var httpConnectionRecord = null;
+        if (connection_type === 'http' && http_connection.base_url) {
+            var httpData = {
+                connection_alias: alias.sys_id,
+                connection_url: http_connection.base_url,
+                use_mutual_auth: http_connection.use_mutual_auth || false
+            };
+            if (http_connection.mid_server) {
+                httpData.mid_server = http_connection.mid_server;
+            }
+            try {
+                var httpResponse = await client.post('/api/now/table/sys_connection', httpData);
+                httpConnectionRecord = httpResponse.data.result;
+            }
+            catch (httpError) {
+                if (httpError.response?.status === 403) {
+                    var httpScript = `
+            var gr = new GlideRecord('sys_connection');
+            gr.initialize();
+            gr.connection_alias = ${JSON.stringify(alias.sys_id)};
+            gr.connection_url = ${JSON.stringify(http_connection.base_url)};
+            gr.use_mutual_auth = ${http_connection.use_mutual_auth || false};
+            ${http_connection.mid_server ? `gr.mid_server = ${JSON.stringify(http_connection.mid_server)};` : ''}
+            var sysId = gr.insert();
+
+            if (sysId) {
+              gs.print(JSON.stringify({
+                sys_id: sysId,
+                connection_url: gr.connection_url.toString()
+              }));
+            }
+          `;
+                    var httpScriptResponse = await client.post('/api/now/table/sys_script_execution', {
+                        script: httpScript,
+                        description: 'Create HTTP connection for alias: ' + name
+                    });
+                    var httpOutput = httpScriptResponse.data.result?.output || '';
+                    var httpMatch = httpOutput.match(/\{[^}]+\}/);
+                    if (httpMatch) {
+                        httpConnectionRecord = JSON.parse(httpMatch[0]);
+                    }
+                }
+            }
+        }
+        return (0, error_handler_js_1.createSuccessResult)({
+            created: true,
+            method: usedBackgroundScript ? 'background_script' : 'table_api',
+            connection_alias: {
+                sys_id: alias.sys_id,
+                name: alias.name || name,
+                type: connection_type,
+                active: active
+            },
+            http_connection: httpConnectionRecord ? {
+                sys_id: httpConnectionRecord.sys_id,
+                base_url: http_connection.base_url
+            } : null,
+            usage_instructions: [
+                'Use this alias in Flow Designer actions',
+                'Reference in REST steps: alias=' + name,
+                'Configure credentials via snow_create_credential_alias if needed'
+            ]
+        });
+    }
+    catch (error) {
+        if (error.response?.status === 403) {
+            return (0, error_handler_js_1.createErrorResult)('Permission denied (403): Your ServiceNow user lacks permissions to create connection aliases. ' +
+                'Required roles: "connection_admin" or "admin". Please contact your ServiceNow administrator.');
+        }
+        return (0, error_handler_js_1.createErrorResult)(error.message);
+    }
+}
+exports.version = '1.0.0';
+exports.author = 'Snow-Flow Team';
+//# sourceMappingURL=snow_create_connection_alias.js.map

package/dist/mcp/servicenow-mcp-unified/tools/integration/snow_create_connection_alias.js.map

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

package/dist/mcp/servicenow-mcp-unified/tools/integration/snow_create_credential_alias.d.ts

@@ -0,0 +1,12 @@
+/**
+ * snow_create_credential_alias - Create Credential Aliases for secure authentication
+ *
+ * Create credential aliases to securely store and reference authentication
+ * credentials for external integrations (API keys, Basic Auth, OAuth).
+ */
+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_create_credential_alias.d.ts.map

package/dist/mcp/servicenow-mcp-unified/tools/integration/snow_create_credential_alias.d.ts.map

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

package/dist/mcp/servicenow-mcp-unified/tools/integration/snow_create_credential_alias.js

@@ -0,0 +1,280 @@
+"use strict";
+/**
+ * snow_create_credential_alias - Create Credential Aliases for secure authentication
+ *
+ * Create credential aliases to securely store and reference authentication
+ * credentials for external integrations (API keys, Basic Auth, OAuth).
+ */
+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_create_credential_alias',
+    description: 'Create credential alias for secure storage of API keys, passwords, and OAuth tokens',
+    category: 'integration',
+    subcategory: 'credentials',
+    use_cases: ['credentials', 'security', 'authentication', 'api-keys'],
+    complexity: 'intermediate',
+    frequency: 'medium',
+    permission: 'write',
+    allowedRoles: ['developer', 'admin'],
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'Credential alias name (e.g., "Jira API Credentials", "AWS Access Keys")'
+            },
+            type: {
+                type: 'string',
+                enum: ['basic', 'api_key', 'oauth2', 'ssh', 'certificate', 'custom'],
+                description: 'Type of credential',
+                default: 'basic'
+            },
+            basic_auth: {
+                type: 'object',
+                description: 'Basic authentication credentials',
+                properties: {
+                    username: {
+                        type: 'string',
+                        description: 'Username'
+                    },
+                    password: {
+                        type: 'string',
+                        description: 'Password (stored encrypted)'
+                    }
+                }
+            },
+            api_key: {
+                type: 'object',
+                description: 'API key credentials',
+                properties: {
+                    key: {
+                        type: 'string',
+                        description: 'API key value (stored encrypted)'
+                    },
+                    header_name: {
+                        type: 'string',
+                        description: 'Header name for API key (e.g., "X-API-Key", "Authorization")',
+                        default: 'X-API-Key'
+                    },
+                    prefix: {
+                        type: 'string',
+                        description: 'Prefix for the key value (e.g., "Bearer ", "Api-Key ")'
+                    }
+                }
+            },
+            oauth2: {
+                type: 'object',
+                description: 'OAuth 2.0 credential reference',
+                properties: {
+                    oauth_profile_id: {
+                        type: 'string',
+                        description: 'sys_id of the OAuth profile to use'
+                    }
+                }
+            },
+            active: {
+                type: 'boolean',
+                description: 'Whether the credential is active',
+                default: true
+            },
+            tag: {
+                type: 'string',
+                description: 'Tag for organizing credentials'
+            }
+        },
+        required: ['name', 'type']
+    }
+};
+async function execute(args, context) {
+    var name = args.name;
+    var type = args.type || 'basic';
+    var basic_auth = args.basic_auth || {};
+    var api_key = args.api_key || {};
+    var oauth2 = args.oauth2 || {};
+    var active = args.active !== false;
+    var tag = args.tag || '';
+    try {
+        var client = await (0, auth_js_1.getAuthenticatedClient)(context);
+        var usedBackgroundScript = false;
+        // First create the credential alias record
+        var aliasData = {
+            name: name,
+            type: type,
+            active: active
+        };
+        if (tag) {
+            aliasData.tag = tag;
+        }
+        var aliasResponse;
+        try {
+            aliasResponse = await client.post('/api/now/table/sys_alias', aliasData);
+        }
+        catch (tableError) {
+            if (tableError.response?.status === 403) {
+                usedBackgroundScript = true;
+                var script = `
+          var gr = new GlideRecord('sys_alias');
+          gr.initialize();
+          gr.name = ${JSON.stringify(name)};
+          gr.type = 'credential';
+          gr.active = ${active};
+          ${tag ? `gr.tag = ${JSON.stringify(tag)};` : ''}
+          var sysId = gr.insert();
+
+          if (sysId) {
+            gs.print(JSON.stringify({
+              sys_id: sysId,
+              name: gr.name.toString()
+            }));
+          } else {
+            gs.error('Failed to create credential alias');
+          }
+        `;
+                var scriptResponse = await client.post('/api/now/table/sys_script_execution', {
+                    script: script,
+                    description: 'Create credential alias: ' + name
+                });
+                var output = scriptResponse.data.result?.output || '';
+                var match = output.match(/\{[^}]+\}/);
+                if (match) {
+                    aliasResponse = { data: { result: JSON.parse(match[0]) } };
+                }
+                else {
+                    throw new Error('Failed to create credential alias via background script');
+                }
+            }
+            else {
+                throw tableError;
+            }
+        }
+        var alias = aliasResponse.data.result;
+        var credentialRecord = null;
+        // Create the actual credential record based on type
+        if (type === 'basic' && basic_auth.username) {
+            var basicData = {
+                name: name + ' - Basic Auth',
+                user_name: basic_auth.username,
+                password: basic_auth.password || ''
+            };
+            try {
+                var basicResponse = await client.post('/api/now/table/basic_auth_credentials', basicData);
+                credentialRecord = basicResponse.data.result;
+            }
+            catch (basicError) {
+                if (basicError.response?.status === 403) {
+                    var basicScript = `
+            var gr = new GlideRecord('basic_auth_credentials');
+            gr.initialize();
+            gr.name = ${JSON.stringify(name + ' - Basic Auth')};
+            gr.user_name = ${JSON.stringify(basic_auth.username)};
+            gr.password = ${JSON.stringify(basic_auth.password || '')};
+            var sysId = gr.insert();
+
+            if (sysId) {
+              gs.print(JSON.stringify({
+                sys_id: sysId,
+                name: gr.name.toString(),
+                user_name: gr.user_name.toString()
+              }));
+            }
+          `;
+                    var basicScriptResponse = await client.post('/api/now/table/sys_script_execution', {
+                        script: basicScript,
+                        description: 'Create basic auth credential: ' + name
+                    });
+                    var basicOutput = basicScriptResponse.data.result?.output || '';
+                    var basicMatch = basicOutput.match(/\{[^}]+\}/);
+                    if (basicMatch) {
+                        credentialRecord = JSON.parse(basicMatch[0]);
+                    }
+                }
+            }
+        }
+        else if (type === 'api_key' && api_key.key) {
+            var apiKeyData = {
+                name: name + ' - API Key',
+                api_key: api_key.key,
+                api_key_header: api_key.header_name || 'X-API-Key'
+            };
+            try {
+                var apiKeyResponse = await client.post('/api/now/table/api_key_credentials', apiKeyData);
+                credentialRecord = apiKeyResponse.data.result;
+            }
+            catch (apiKeyError) {
+                if (apiKeyError.response?.status === 403) {
+                    var apiKeyScript = `
+            var gr = new GlideRecord('api_key_credentials');
+            gr.initialize();
+            gr.name = ${JSON.stringify(name + ' - API Key')};
+            gr.api_key = ${JSON.stringify(api_key.key)};
+            gr.api_key_header = ${JSON.stringify(api_key.header_name || 'X-API-Key')};
+            var sysId = gr.insert();
+
+            if (sysId) {
+              gs.print(JSON.stringify({
+                sys_id: sysId,
+                name: gr.name.toString(),
+                header: gr.api_key_header.toString()
+              }));
+            }
+          `;
+                    var apiKeyScriptResponse = await client.post('/api/now/table/sys_script_execution', {
+                        script: apiKeyScript,
+                        description: 'Create API key credential: ' + name
+                    });
+                    var apiKeyOutput = apiKeyScriptResponse.data.result?.output || '';
+                    var apiKeyMatch = apiKeyOutput.match(/\{[^}]+\}/);
+                    if (apiKeyMatch) {
+                        credentialRecord = JSON.parse(apiKeyMatch[0]);
+                    }
+                }
+            }
+        }
+        // Link credential to alias if we created one
+        if (credentialRecord && alias.sys_id) {
+            try {
+                await client.patch('/api/now/table/sys_alias/' + alias.sys_id, {
+                    credential: credentialRecord.sys_id
+                });
+            }
+            catch (linkError) {
+                // Non-critical, alias still works
+            }
+        }
+        return (0, error_handler_js_1.createSuccessResult)({
+            created: true,
+            method: usedBackgroundScript ? 'background_script' : 'table_api',
+            credential_alias: {
+                sys_id: alias.sys_id,
+                name: alias.name || name,
+                type: type,
+                active: active
+            },
+            credential: credentialRecord ? {
+                sys_id: credentialRecord.sys_id,
+                name: credentialRecord.name,
+                type: type
+            } : null,
+            security_note: 'Credentials are stored encrypted in ServiceNow. Never expose credentials in logs or outputs.',
+            usage: [
+                'Reference this alias in connection configurations',
+                'Use in Flow Designer REST actions',
+                'Reference in snow_create_connection_alias for full connection setup'
+            ]
+        });
+    }
+    catch (error) {
+        if (error.response?.status === 403) {
+            return (0, error_handler_js_1.createErrorResult)('Permission denied (403): Your ServiceNow user lacks permissions to create credentials. ' +
+                'Required roles: "credentials_admin" or "admin". Please contact your ServiceNow administrator.');
+        }
+        return (0, error_handler_js_1.createErrorResult)(error.message);
+    }
+}
+exports.version = '1.0.0';
+exports.author = 'Snow-Flow Team';
+//# sourceMappingURL=snow_create_credential_alias.js.map

package/dist/mcp/servicenow-mcp-unified/tools/integration/snow_create_credential_alias.js.map

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

package/dist/mcp/servicenow-mcp-unified/tools/integration/snow_create_flow_action.d.ts

@@ -0,0 +1,12 @@
+/**
+ * snow_create_flow_action - Create custom IntegrationHub actions
+ *
+ * Create custom Flow Designer actions for IntegrationHub to extend
+ * spoke capabilities or create new integrations.
+ */
+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_create_flow_action.d.ts.map

package/dist/mcp/servicenow-mcp-unified/tools/integration/snow_create_flow_action.d.ts.map

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