snow-flow 1.3.20 → 1.3.22

package/dist/mcp/servicenow-flow-composer-mcp.js

@@ -350,20 +350,42 @@ class ServiceNowFlowComposerMCP {
                     // Generate production-ready XML
                     const xmlResult = generateProductionFlowXML(xmlFlowDef);
                     console.log('✅ XML generated:', xmlResult.filePath);
-                    // Auto-deploy XML to ServiceNow
-                    await this.deployXMLToServiceNow(xmlResult.filePath);
+                    // Auto-deploy with fallback strategies
+                    const deployResult = await this.deployWithFallback(xmlResult.filePath, flowDefinition);
+                    // Verify deployment was successful
+                    const flowExists = await this.verifyFlowInServiceNow(parsedIntent.flowName);
+                    if (!flowExists) {
+                        throw new Error('Flow deployment claimed success but flow not found in ServiceNow');
+                    }
                     deploymentResult = {
                         success: true,
-                        method: 'xml_first',
+                        method: deployResult.strategy,
                         xml_file: xmlResult.filePath,
-                        message: '✅ Flow deployed using XML-first approach!'
+                        message: `✅ Flow deployed via ${deployResult.strategy} and verified in ServiceNow!`,
+                        flow_sys_id: flowExists.sys_id
                     };
                 }
                 catch (xmlError) {
-                    console.warn('⚠️ XML deployment failed, providing manual instructions:', xmlError);
+                    console.error('❌ XML deployment failed:', xmlError);
+                    // Extract detailed error information
+                    let errorDetails = 'Unknown error';
+                    if (xmlError instanceof Error) {
+                        errorDetails = xmlError.message;
+                        // Check for specific error types
+                        if (xmlError.message.includes('400')) {
+                            errorDetails = 'ServiceNow rejected the request. Check permissions and Update Set.';
+                        }
+                        else if (xmlError.message.includes('401') || xmlError.message.includes('403')) {
+                            errorDetails = 'Authentication failed. Run: snow-flow auth login';
+                        }
+                    }
                     deploymentResult = {
                         success: false,
-                        error: xmlError instanceof Error ? xmlError.message : String(xmlError),
+                        error: errorDetails,
+                        xml_generated: true,
+                        xml_path: xmlResult?.filePath,
+                        deployment_failed: true,
+                        manual_steps: this.generateManualImportGuide(xmlResult?.filePath || ''),
                         fallback_instructions: 'Use snow-flow deploy-xml command for manual deployment'
                     };
                 }
@@ -374,9 +396,22 @@ class ServiceNowFlowComposerMCP {
                 content: [
                     {
                         type: 'text',
-                        text: `🎯 FLOW CREATED WITH XML-FIRST APPROACH!
+                        text: deploymentResult?.success ?
+                            `✅ FLOW SUCCESSFULLY CREATED AND DEPLOYED!
+
+🚀 **VERIFIED DEPLOYMENT** - Flow is now live in ServiceNow!` :
+                            deploymentResult?.deployment_failed ?
+                                `⚠️ FLOW XML GENERATED BUT DEPLOYMENT FAILED
+
+❌ **Deployment Error**: ${deploymentResult.error}
 
-${args.deploy_immediately !== false ? `🚀 **FULLY AUTOMATED DEPLOYMENT** - XML generated & deployed to ServiceNow!` : `📋 **PLANNING MODE** - Flow structure generated`}
+📁 **XML File**: ${deploymentResult.xml_path}
+
+📋 **Manual Import Steps**:
+${deploymentResult.manual_steps || '1. Navigate to System Update Sets > Retrieved Update Sets\n2. Import Update Set from XML\n3. Preview and Commit'}` :
+                                `🎯 FLOW CREATED WITH XML-FIRST APPROACH!
+
+${args.deploy_immediately !== false ? `🚀 **DEPLOYMENT STATUS** - Processing...` : `📋 **PLANNING MODE** - Flow structure generated`}
 
 🧠 **Intelligent Analysis:**
 - **Flow Name**: ${parsedIntent.flowName}
@@ -394,11 +429,11 @@ ${args.deploy_immediately !== false ? `🚀 **FULLY AUTOMATED DEPLOYMENT** - XML
 
 🚀 **XML-First Deployment:**
 ${deploymentResult ? (deploymentResult.success ?
-                            `✅ Successfully deployed using XML-first approach!
+                                    `✅ Successfully deployed using XML-first approach!
 - **Method**: Production-ready Update Set XML
 - **XML File**: ${deploymentResult.xml_file}
 - **Status**: Imported → Previewed → Committed ✅` :
-                            `❌ Auto-deployment failed: ${deploymentResult.error}
+                                    `❌ Auto-deployment failed: ${deploymentResult.error}
 - **Fallback**: ${deploymentResult.fallback_instructions}`) : '⏳ Ready for deployment'}
 
 🔗 **ServiceNow Access:**
@@ -1951,6 +1986,109 @@ ${categoryFilteredResults.length === 0 ? `🔍 **No templates found matching you
         };
         return mapping[activityType.toLowerCase()] || 'script';
     }
+    /**
+     * Verify flow exists in ServiceNow after deployment
+     */
+    async verifyFlowInServiceNow(flowName) {
+        try {
+            const ServiceNowClient = (await Promise.resolve().then(() => __importStar(require('../utils/servicenow-client.js')))).ServiceNowClient;
+            const client = new ServiceNowClient();
+            // Check if flow exists in sys_hub_flow
+            const flowCheck = await client.makeRequest({
+                method: 'GET',
+                url: '/api/now/table/sys_hub_flow',
+                params: {
+                    sysparm_query: `name=${flowName}`,
+                    sysparm_limit: 1
+                }
+            });
+            if (flowCheck.result && flowCheck.result.length > 0) {
+                return flowCheck.result[0];
+            }
+            return null;
+        }
+        catch (error) {
+            this.logger.error('Failed to verify flow:', error);
+            return null;
+        }
+    }
+    /**
+     * Generate manual import guide for failed deployments
+     */
+    generateManualImportGuide(xmlFilePath) {
+        return `
+1. **Navigate to ServiceNow**:
+   - System Update Sets > Retrieved Update Sets
+   
+2. **Import XML**:
+   - Click "Import Update Set from XML"
+   - Select file: ${xmlFilePath}
+   - Click "Upload"
+   
+3. **Preview**:
+   - Find your imported update set
+   - Click "Preview Update Set"
+   - Review any conflicts or issues
+   
+4. **Commit**:
+   - If preview is clean, click "Commit Update Set"
+   - Your flow will be available in Flow Designer
+   
+5. **Verify**:
+   - Navigate to Flow Designer
+   - Check "My Flows" for your new flow`;
+    }
+    /**
+     * Deploy with fallback strategies
+     */
+    async deployWithFallback(xmlFilePath, flowDefinition) {
+        const strategies = [
+            {
+                name: 'XML Remote Update Set',
+                fn: async () => await this.deployXMLToServiceNow(xmlFilePath)
+            },
+            {
+                name: 'Direct Table API',
+                fn: async () => await this.deployViaTableAPI(flowDefinition)
+            }
+        ];
+        let lastError;
+        for (const strategy of strategies) {
+            try {
+                this.logger.info(`Trying deployment strategy: ${strategy.name}`);
+                const result = await strategy.fn();
+                return { success: true, strategy: strategy.name, result };
+            }
+            catch (error) {
+                this.logger.warn(`Strategy ${strategy.name} failed:`, error);
+                lastError = error;
+            }
+        }
+        throw lastError || new Error('All deployment strategies failed');
+    }
+    /**
+     * Deploy via direct table API
+     */
+    async deployViaTableAPI(flowDefinition) {
+        const ServiceNowClient = (await Promise.resolve().then(() => __importStar(require('../utils/servicenow-client.js')))).ServiceNowClient;
+        const client = new ServiceNowClient();
+        // Try to create flow directly in sys_hub_flow
+        const flowResponse = await client.makeRequest({
+            method: 'POST',
+            url: '/api/now/table/sys_hub_flow',
+            data: {
+                name: flowDefinition.name,
+                description: flowDefinition.description,
+                active: true,
+                // Additional flow properties
+                table: flowDefinition.table
+            }
+        });
+        if (!flowResponse.result || !flowResponse.result.sys_id) {
+            throw new Error('Failed to create flow via Table API');
+        }
+        this.logger.info(`Flow created via Table API: ${flowResponse.result.sys_id}`);
+    }
     /**
      * Deploy XML file to ServiceNow automatically
      */
@@ -1963,32 +2101,86 @@ ${categoryFilteredResults.length === 0 ? `🔍 **No templates found matching you
         // Initialize ServiceNow client
         const ServiceNowClient = (await Promise.resolve().then(() => __importStar(require('../utils/servicenow-client.js')))).ServiceNowClient;
         const client = new ServiceNowClient();
+        // Check for active Update Set first
+        let currentUpdateSet;
+        try {
+            const updateSetResponse = await client.makeRequest({
+                method: 'GET',
+                url: '/api/now/table/sys_update_set',
+                params: {
+                    sysparm_query: 'state=in progress^nameNOT LIKEDefault',
+                    sysparm_limit: 1
+                }
+            });
+            if (!updateSetResponse.result || updateSetResponse.result.length === 0) {
+                this.logger.warn('No active Update Set found. Flow will be imported but not tracked properly.');
+                // Continue anyway - let ServiceNow handle it
+            }
+            else {
+                currentUpdateSet = updateSetResponse.result[0];
+                this.logger.info(`Active Update Set found: ${currentUpdateSet.name}`);
+            }
+        }
+        catch (error) {
+            this.logger.warn('Could not check for active Update Set:', error);
+            // Continue anyway
+        }
         // Read the XML file
         const fs = require('fs').promises;
         const xmlContent = await fs.readFile(xmlFilePath, 'utf-8');
         // Import XML as remote update set
-        const importResponse = await client.makeRequest({
-            method: 'POST',
-            url: '/api/now/table/sys_remote_update_set',
-            headers: {
-                'Content-Type': 'application/xml',
-                'Accept': 'application/json'
-            },
-            data: xmlContent
-        });
+        let importResponse;
+        try {
+            importResponse = await client.makeRequest({
+                method: 'POST',
+                url: '/api/now/table/sys_remote_update_set',
+                headers: {
+                    'Content-Type': 'application/xml',
+                    'Accept': 'application/json'
+                },
+                data: xmlContent
+            });
+        }
+        catch (error) {
+            // Enhanced error handling with detailed messages
+            if (error.response?.status === 400) {
+                const errorDetail = error.response.data?.error?.detail ||
+                    error.response.data?.error?.message ||
+                    'Unknown error';
+                this.logger.error('ServiceNow 400 Error:', {
+                    status: error.response.status,
+                    statusText: error.response.statusText,
+                    data: error.response.data,
+                    headers: error.response.headers
+                });
+                throw new Error(`ServiceNow rejected the XML: ${errorDetail}. Check if you have an active Update Set.`);
+            }
+            else if (error.response?.status === 401 || error.response?.status === 403) {
+                throw new Error('Authentication failed. Your session may have expired. Run: snow-flow auth login');
+            }
+            else {
+                throw new Error(`Failed to import XML: ${error.message}`);
+            }
+        }
         if (!importResponse.result || !importResponse.result.sys_id) {
             throw new Error('Failed to import XML update set');
         }
         const remoteUpdateSetId = importResponse.result.sys_id;
         this.logger.info(`✅ XML imported successfully (sys_id: ${remoteUpdateSetId})`);
         // Load the update set
-        await client.makeRequest({
-            method: 'PUT',
-            url: `/api/now/table/sys_remote_update_set/${remoteUpdateSetId}`,
-            data: {
-                state: 'loaded'
-            }
-        });
+        try {
+            await client.makeRequest({
+                method: 'PUT',
+                url: `/api/now/table/sys_remote_update_set/${remoteUpdateSetId}`,
+                data: {
+                    state: 'loaded'
+                }
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to load update set:', error);
+            throw new Error(`Failed to load update set: ${error.message}. You may need to load it manually.`);
+        }
         // Find the loaded update set
         const loadedResponse = await client.makeRequest({
             method: 'GET',
@@ -2004,10 +2196,16 @@ ${categoryFilteredResults.length === 0 ? `🔍 **No templates found matching you
         const updateSetId = loadedResponse.result[0].sys_id;
         const updateSetName = loadedResponse.result[0].name;
         // Preview the update set
-        await client.makeRequest({
-            method: 'POST',
-            url: `/api/now/table/sys_update_set/${updateSetId}/preview`
-        });
+        try {
+            await client.makeRequest({
+                method: 'POST',
+                url: `/api/now/table/sys_update_set/${updateSetId}/preview`
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to preview update set:', error);
+            // Continue anyway, as preview might fail but commit could still work
+        }
         // Check for preview problems
         const previewProblems = await client.makeRequest({
             method: 'GET',
@@ -2022,11 +2220,17 @@ ${categoryFilteredResults.length === 0 ? `🔍 **No templates found matching you
             throw new Error(`Preview found problems:\n${problemsList}\n\nPlease review and resolve in ServiceNow UI`);
         }
         // Commit the update set
-        await client.makeRequest({
-            method: 'POST',
-            url: `/api/now/table/sys_update_set/${updateSetId}/commit`
-        });
-        this.logger.info(`✅ Update set committed successfully: ${updateSetName}`);
+        try {
+            await client.makeRequest({
+                method: 'POST',
+                url: `/api/now/table/sys_update_set/${updateSetId}/commit`
+            });
+            this.logger.info(`✅ Update set committed successfully: ${updateSetName}`);
+        }
+        catch (error) {
+            this.logger.error('Failed to commit update set:', error);
+            throw new Error(`Failed to commit update set. Manual intervention required in ServiceNow UI.`);
+        }
     }
 }
 // Start the server

package/dist/version.js

@@ -7,7 +7,7 @@ exports.VERSION_INFO = exports.VERSION = void 0;
 exports.getVersionString = getVersionString;
 exports.getLatestFeatures = getLatestFeatures;
 exports.isLatestVersion = isLatestVersion;
-exports.VERSION = '1.3.16';
+exports.VERSION = '1.3.22';
 exports.VERSION_INFO = {
     version: exports.VERSION,
     name: 'Snow-Flow',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snow-flow",
-  "version": "1.3.20",
+  "version": "1.3.22",
   "description": "ServiceNow Queen Agent - Hive-Mind Intelligence for ServiceNow Development inspired by claude-flow. Transform complex workflows into elegant one-command orchestration.",
   "main": "dist/index.js",
   "type": "commonjs",