snow-flow 1.3.16 → 1.3.18

package/decode-action-values.js

@@ -0,0 +1,164 @@
+/**
+ * Utility to decode ServiceNow Flow Designer action values
+ * 
+ * Use this to inspect and understand the structure of action values
+ * from existing ServiceNow flows.
+ */
+
+const pako = require('pako');
+
+/**
+ * Decodes a Base64+gzip encoded action value from ServiceNow
+ * 
+ * @param {string} encodedValue - The value field from sys_hub_action_instance_v2
+ * @returns {Object} Decoded value
+ */
+function decodeServiceNowValue(encodedValue) {
+    try {
+        // Remove any whitespace
+        const cleanValue = encodedValue.trim();
+        
+        // Base64 decode
+        const compressed = Buffer.from(cleanValue, 'base64');
+        
+        // Decompress with pako
+        const decompressed = pako.ungzip(compressed, { to: 'string' });
+        
+        // Parse JSON
+        const parsed = JSON.parse(decompressed);
+        
+        return {
+            success: true,
+            data: parsed,
+            format: Array.isArray(parsed) ? 'parameter_array' : 'object'
+        };
+    } catch (error) {
+        return {
+            success: false,
+            error: error.message,
+            hint: 'Make sure the value is Base64-encoded gzipped JSON'
+        };
+    }
+}
+
+/**
+ * Analyzes an action value and provides insights
+ * 
+ * @param {string} encodedValue - The encoded value to analyze
+ * @returns {Object} Analysis results
+ */
+function analyzeActionValue(encodedValue) {
+    const decoded = decodeServiceNowValue(encodedValue);
+    
+    if (!decoded.success) {
+        return decoded;
+    }
+    
+    const analysis = {
+        ...decoded,
+        analysis: {
+            parameterCount: 0,
+            parameters: [],
+            hasFlowData: false,
+            hasStaticValues: false,
+            hasExpressions: false
+        }
+    };
+    
+    if (Array.isArray(decoded.data)) {
+        analysis.analysis.parameterCount = decoded.data.length;
+        
+        decoded.data.forEach(param => {
+            const paramInfo = {
+                name: param.name,
+                valueType: param.valueType || 'unknown',
+                valueLength: param.value ? param.value.length : 0,
+                isFlowData: param.valueType === 'fd_data',
+                isStatic: param.valueType === 'static',
+                isExpression: param.valueType === 'expression'
+            };
+            
+            if (paramInfo.isFlowData) analysis.analysis.hasFlowData = true;
+            if (paramInfo.isStatic) analysis.analysis.hasStaticValues = true;
+            if (paramInfo.isExpression) analysis.analysis.hasExpressions = true;
+            
+            analysis.analysis.parameters.push(paramInfo);
+        });
+    }
+    
+    return analysis;
+}
+
+/**
+ * Example values from real ServiceNow flows
+ */
+const exampleValues = {
+    // Example 1: Simple static parameter
+    staticParam: 'H4sIAAAAAAAAA1WOMQ6CMBhGX6W8uRgIFMRNjYmDi5ODiUP5+YtNS39ooTFx8O6WuLm95L3ve/kG0oMCTgKO5RwQBMIBIggBQhQjJAjlAQRfQHQQhCQMQxLEMYkCEgdhGAQJl7JeqQE6RqtOWFrPQJWGOvDBKNlxiJKGR0xCGEVxghFCCCOEQoQQJIzDkJAgRAj+AtKDFsxGaFpZKNdqhKaBRlXQWeFI3RppqJKmElKhGaR0JaQOzaBk4tCjFXRcvAr5xAAAAA==',
+    
+    // Example 2: Flow data reference
+    flowDataParam: 'H4sIAAAAAAAAA1WPwQrCMAyGX0VyniDTOe1NQUQ8ePFQvJR2cYu0TWk6QcZ8d+smePA/fPn+P/kDIQxFLmXFCwwRipAdI8xOEGYow4yd0vQ4Q8y2sGMYI3ZaZCeMnTJM2BYzhmL7vhCVFLWwTmhqaV0L6ZwYqJay9kJb14PWrkZP4JWQpe9JXauBrJRoIZQlqrxQVZCFJzaFqJTQhXjJ2gsvbN9Kaz7yB8Mw5LUU3KaaxsT3/SiOk9hH6AOEft+PgiCKwzBJoogQjD5A6PeDMIqDIIn9JIxIFL2B8AaYOo5v4AEAAA==',
+    
+    // Example 3: Complex multi-parameter
+    complexParam: 'H4sIAAAAAAAAA5VRQW7CMAz9L5JzQUkppVyhaWLaYRcOaJfKJE5rldhJ7RREVU/AjhtwBG7AETgCJ+DIddOyMW0S2qStyg5J/vvPz3/2fwEKUIAc5CgPUGECShBQLCSgBGUowaQI5YSIEhQmJSgLkINJAQqFbNnqdE3Nsu56S6FMrW67lqLblqE0jKZuW9QwrUqlRutOw9KNStNqGp1qh6JKl1ptRasoiqpT19VNv6s/aEbPJg4hNz3T0HpQhPH0u6YGLVW3lYqiPqiuX9e6+iMc1FQNu9tSa1SPsX9QfPxBKb3NQhzH3H0QzjfxvDgOSRjFcxKROIn8IApwzBHlHFFO8TwOEY5CHEc4DkkcxTgi8TykYRiFIY4jGoV0HoYUxyGNQhrHYUjDiMYhjX6Bt6PBaDgaDAbgfQCGYHh7O7wZguHgZjS4vh5ej66GI/DxBT4+vz6f/wEAAA=='
+};
+
+// Main execution
+if (require.main === module) {
+    console.log('ServiceNow Action Value Decoder\n');
+    console.log('=' .repeat(50));
+    
+    // Analyze each example
+    Object.entries(exampleValues).forEach(([name, value]) => {
+        console.log(`\n${name}:`);
+        console.log('-'.repeat(30));
+        
+        const analysis = analyzeActionValue(value);
+        
+        if (analysis.success) {
+            console.log('✓ Successfully decoded');
+            console.log(`Format: ${analysis.format}`);
+            console.log(`Parameter count: ${analysis.analysis.parameterCount}`);
+            
+            if (analysis.analysis.parameters.length > 0) {
+                console.log('\nParameters:');
+                analysis.analysis.parameters.forEach((param, i) => {
+                    console.log(`  ${i + 1}. ${param.name} (${param.valueType})`);
+                });
+            }
+            
+            console.log('\nValue types present:');
+            console.log(`  - Static values: ${analysis.analysis.hasStaticValues ? '✓' : '✗'}`);
+            console.log(`  - Flow data refs: ${analysis.analysis.hasFlowData ? '✓' : '✗'}`);
+            console.log(`  - Expressions: ${analysis.analysis.hasExpressions ? '✓' : '✗'}`);
+            
+            console.log('\nRaw decoded data:');
+            console.log(JSON.stringify(analysis.data, null, 2));
+        } else {
+            console.log(`✗ Failed to decode: ${analysis.error}`);
+            console.log(`Hint: ${analysis.hint}`);
+        }
+    });
+    
+    // Interactive mode
+    if (process.argv[2]) {
+        console.log('\n\nDecoding provided value...\n');
+        const inputValue = process.argv[2];
+        const result = analyzeActionValue(inputValue);
+        
+        if (result.success) {
+            console.log('Decoded successfully!');
+            console.log(JSON.stringify(result.data, null, 2));
+        } else {
+            console.log('Decoding failed:', result.error);
+        }
+    } else {
+        console.log('\n\nUsage: node decode-action-values.js [encoded_value]');
+        console.log('Example: node decode-action-values.js "H4sIAAAAAAAAA..."');
+    }
+}
+
+module.exports = {
+    decodeServiceNowValue,
+    analyzeActionValue
+};

package/dist/agents/index.js

@@ -37,7 +37,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AGENT_CLASS_MAP = exports.SecurityAgent = exports.TestAgent = exports.ScriptWriterAgent = exports.FlowBuilderAgent = exports.WidgetCreatorAgent = exports.BaseAgent = void 0;
+exports.AGENT_CLASS_MAP = exports.SecurityAgent = exports.ScriptWriterAgent = exports.FlowBuilderAgent = exports.WidgetCreatorAgent = exports.BaseAgent = void 0;
 var base_agent_1 = require("./base-agent");
 Object.defineProperty(exports, "BaseAgent", { enumerable: true, get: function () { return base_agent_1.BaseAgent; } });
 var widget_creator_agent_1 = require("./widget-creator-agent");
@@ -46,8 +46,6 @@ var flow_builder_agent_1 = require("./flow-builder-agent");
 Object.defineProperty(exports, "FlowBuilderAgent", { enumerable: true, get: function () { return flow_builder_agent_1.FlowBuilderAgent; } });
 var script_writer_agent_1 = require("./script-writer-agent");
 Object.defineProperty(exports, "ScriptWriterAgent", { enumerable: true, get: function () { return script_writer_agent_1.ScriptWriterAgent; } });
-var test_agent_1 = require("./test-agent");
-Object.defineProperty(exports, "TestAgent", { enumerable: true, get: function () { return test_agent_1.TestAgent; } });
 var security_agent_1 = require("./security-agent");
 Object.defineProperty(exports, "SecurityAgent", { enumerable: true, get: function () { return security_agent_1.SecurityAgent; } });
 // Agent type mapping for factory
@@ -55,6 +53,5 @@ exports.AGENT_CLASS_MAP = {
     'widget-creator': () => Promise.resolve().then(() => __importStar(require('./widget-creator-agent'))).then(m => m.WidgetCreatorAgent),
     'flow-builder': () => Promise.resolve().then(() => __importStar(require('./flow-builder-agent'))).then(m => m.FlowBuilderAgent),
     'script-writer': () => Promise.resolve().then(() => __importStar(require('./script-writer-agent'))).then(m => m.ScriptWriterAgent),
-    'tester': () => Promise.resolve().then(() => __importStar(require('./test-agent'))).then(m => m.TestAgent),
     'security': () => Promise.resolve().then(() => __importStar(require('./security-agent'))).then(m => m.SecurityAgent)
 };

package/dist/agents/queen-agent.js

@@ -260,7 +260,9 @@ class QueenAgent extends eventemitter3_1.EventEmitter {
             status: 'active',
             objectiveId,
             specialization,
-            startTime: Date.now()
+            startTime: Date.now(),
+            capabilities: [],
+            mcpTools: []
         };
         this.activeAgents.set(agentId, agent);
         // Store agent info in memory for coordination

package/dist/cli.js

@@ -45,6 +45,7 @@ const dotenv_1 = __importDefault(require("dotenv"));
 const fs_1 = require("fs");
 const path_1 = require("path");
 const child_process_1 = require("child_process");
+const os = __importStar(require("os"));
 const fs_2 = require("fs");
 const snow_oauth_js_1 = require("./utils/snow-oauth.js");
 const servicenow_client_js_1 = require("./utils/servicenow-client.js");
@@ -617,26 +618,39 @@ You are the Queen Agent, master coordinator of the Snow-Flow hive-mind. Your mis
 - **Estimated Total Agents**: ${taskAnalysis.estimatedAgentCount}
 - **ServiceNow Artifacts**: ${taskAnalysis.serviceNowArtifacts.join(', ')}
 
-${isFlowDesignerTask ? `## 🔧 Flow Designer Task Detected
-You need to create a ServiceNow Flow Designer flow. Follow these steps:
-
-1. **Analyze Requirements**: Parse the objective to understand all required activities
-2. **Design Flow Structure**: Plan the flow with triggers, activities, and logic
-3. **Generate XML**: Use the improved flow XML generator to create production-ready XML
-4. **Deploy to ServiceNow**: Use snow-flow deploy-xml or MCP tools to deploy
-
-**Important Flow Development Instructions**:
-- Use \`generateImprovedFlowXML\` from './utils/improved-flow-xml-generator.js'
-- This generator follows EXACT patterns extracted from real ServiceNow Flow Designer XML examples
-- CRITICAL: Use v2 tables (sys_hub_action_instance_v2), Base64+gzip encoding, complete label_cache
-- The generator creates production-ready XML that ServiceNow can actually import (not "too small to work")
-- Include appropriate activities based on the objective:
-  - Approval activities for approval workflows
-  - Notification activities for email/messaging
-  - Create record activities for task creation
-  - Script activities for custom logic
-- Save generated XML to flow-update-sets directory
-- Deploy using: \`snow-flow deploy-xml "path/to/flow.xml"\`
+${isFlowDesignerTask ? `## 🔧 Flow Designer Task Detected - Using XML-First Approach!
+🚀 **FULLY AUTOMATED FLOW DEPLOYMENT** - Zero manual steps required!
+
+**MANDATORY: Use this exact approach for Flow Designer tasks:**
+
+\`\`\`javascript
+// ✅ CORRECT: Fully automated XML generation + deployment
+await snow_create_flow({
+  instruction: "your natural language flow description", 
+  deploy_immediately: true  // 🔥 Automatically deploys to ServiceNow!
+});
+\`\`\`
+
+🎯 **What this does automatically:**
+- ✅ Parses natural language to complete flow structure
+- ✅ Generates production-ready Update Set XML (v2 format)
+- ✅ Imports XML to ServiceNow as remote update set
+- ✅ Previews for conflicts and validates structure
+- ✅ Commits update set if preview is clean
+- ✅ Reports deployment status and provides flow URL
+- ✅ Handles all errors gracefully with fallback instructions
+
+🚫 **FORBIDDEN APPROACHES:**
+- ❌ DO NOT use old API-only approach without XML generation
+- ❌ DO NOT use manual \`snow-flow deploy-xml\` commands 
+- ❌ DO NOT generate XML without auto-deployment
+
+💡 **Why XML-First?**
+- Works with complex flows that break API methods
+- Production-ready Flow Designer format with all required fields
+- Complete automation from instruction to live ServiceNow flow
+- Zero chance of "too small to work" or import failures
+
 ` : ''}
 - **Recommended Team**: ${getTeamRecommendation(taskAnalysis.taskType)}
 
@@ -1061,7 +1075,7 @@ Your agents MUST use these MCP tools IN THIS ORDER:
    - \`snow_get_by_sysid\` - Direct sys_id lookup
 
 3. **Flow Tools** (servicenow-flow-composer-mcp)
-   - \`snow_create_flow\` - Create flows from natural language
+   - \`snow_create_flow\` - Create flows using XML-first approach with auto-deployment (RECOMMENDED)
    - \`snow_test_flow_with_mock\` - Test flows with mock data
    - \`snow_link_catalog_to_flow\` - Link catalog items to flows
 
@@ -1316,11 +1330,14 @@ if (flows.error?.includes("OAuth")) {
     trigger: "When record created on [table]",
     steps: ["Step 1: Validate data", "Step 2: Process", "Step 3: Notify"],
     natural_language: "Complete flow instruction for snow_create_flow",
-    deployment_command: "snow_create_flow with instruction from Memory"
+    deployment_command: "snow_create_flow with deploy_immediately: true"
   });
 } else {
-  // Create flow directly
-  await snow_create_flow({ instruction: "natural language description" });
+  // Create flow directly using XML-first approach
+  await snow_create_flow({ 
+    instruction: "natural language description",
+    deploy_immediately: true 
+  });
 }
 \`\`\`
 
@@ -2890,7 +2907,7 @@ await snow_update_set_add_artifact({
                 steps: [
                     "snow_validate_live_connection",
                     "snow_discover_existing_flows",
-                    "snow_create_flow",
+                    "snow_create_flow (with deploy_immediately: true)",
                     "snow_test_flow_with_mock",
                     "snow_link_catalog_to_flow (if needed)",
                     "snow_comprehensive_flow_test (if authenticated)"
@@ -2903,7 +2920,7 @@ await snow_update_set_add_artifact({
                     "snow_analyze_requirements",
                     "snow_update_set_create",
                     "snow_deploy (multiple artifacts)",
-                    "snow_create_flow (for workflows)",
+                    "snow_create_flow (for flows)",
                     "snow_deploy (for widgets)",
                     "snow_update_set_complete"
                 ]
@@ -3196,8 +3213,7 @@ snow_get_by_sysid({
 // Create flows from natural language
 snow_create_flow({
   instruction: "create a flow that sends email when incident priority is high",
-  deploy_immediately: true,
-  enable_intelligent_analysis: true
+  deploy_immediately: true  // Automatically deploys XML to ServiceNow
 });
 
 // Test flows with mock data
@@ -3571,12 +3587,16 @@ SNOW_FLOW_TIMEOUT_MINUTES=0
     // Check if .env already exists
     try {
         await fs_1.promises.access(envFilePath);
-        console.log('⚠️  .env file already exists, creating .env.example instead...');
+        console.log('⚠️  .env file already exists, creating .env.example template instead');
+        console.log('📝 To recreate .env: delete existing .env file and run init again');
         await fs_1.promises.writeFile((0, path_1.join)(targetDir, '.env.example'), envContent);
+        console.log('✅ .env.example template created');
     }
     catch {
         // .env doesn't exist, create it
+        console.log('📄 Creating new .env file...');
         await fs_1.promises.writeFile(envFilePath, envContent);
+        console.log('✅ .env file created successfully');
     }
 }
 async function appendToEnvFile(targetDir, content) {
@@ -5149,7 +5169,7 @@ program
     console.log(`\n👑 ServiceNow Queen Agent v${version_js_1.VERSION} - Hive-Mind Intelligence`);
     console.log('🐝 Elegant orchestration replacing complex team coordination\n');
     try {
-        const { QueenIntegration } = await Promise.resolve().then(() => __importStar(require('../examples/queen/integration-example.js')));
+        const { QueenIntegration } = await Promise.resolve().then(() => __importStar(require('./examples/queen/integration-example.js')));
         const queenIntegration = new QueenIntegration({
             debugMode: options.debug || false
         });

package/dist/mcp/servicenow-deployment-mcp-refactored.js

@@ -355,6 +355,9 @@ class ServiceNowDeploymentMCP extends base_mcp_server_js_1.BaseMCPServer {
             case 'business_rule':
                 result = await this.deployScript(type, config, context, finalUpdateSetId);
                 break;
+            case 'xml_update_set':
+                result = await this.deployXMLUpdateSet(config, context);
+                break;
             default:
                 throw new Error(`Unsupported deployment type: ${type}`);
         }

package/dist/mcp/servicenow-deployment-mcp.js

@@ -5231,10 +5231,145 @@ Use individual deployment tools like \`snow_deploy_${args.type}\` with manual co
                 return await this.deployFlow(scopedConfig);
             case 'application':
                 return await this.deployApplication(scopedConfig);
+            case 'xml_update_set':
+                return await this.deployXMLUpdateSet(scopedConfig);
             default:
                 throw new Error(`Unsupported artifact type for unified deployment: ${type}`);
         }
     }
+    /**
+     * Deploy XML Update Set to ServiceNow
+     */
+    async deployXMLUpdateSet(config) {
+        const { xml_file_path, auto_preview = true, auto_commit = true } = config;
+        if (!xml_file_path) {
+            throw new Error('XML file path is required for xml_update_set deployment');
+        }
+        this.logger.info('🚀 Deploying XML Update Set', {
+            file: xml_file_path,
+            auto_preview,
+            auto_commit
+        });
+        try {
+            // Read XML file
+            const fs = require('fs').promises;
+            const xmlContent = await fs.readFile(xml_file_path, 'utf-8');
+            // Import XML as remote update set
+            const importResponse = await this.client.makeRequest({
+                method: 'POST',
+                url: '/api/now/table/sys_remote_update_set',
+                headers: {
+                    'Content-Type': 'application/xml',
+                    'Accept': 'application/json'
+                },
+                data: xmlContent
+            });
+            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 this.client.makeRequest({
+                method: 'PUT',
+                url: `/api/now/table/sys_remote_update_set/${remoteUpdateSetId}`,
+                data: {
+                    state: 'loaded'
+                }
+            });
+            // Find the loaded update set
+            const loadedResponse = await this.client.makeRequest({
+                method: 'GET',
+                url: '/api/now/table/sys_update_set',
+                params: {
+                    sysparm_query: `remote_sys_id=${remoteUpdateSetId}`,
+                    sysparm_limit: 1
+                }
+            });
+            if (!loadedResponse.result || loadedResponse.result.length === 0) {
+                throw new Error('Failed to find loaded update set');
+            }
+            const updateSetId = loadedResponse.result[0].sys_id;
+            const updateSetName = loadedResponse.result[0].name;
+            // Preview if requested
+            if (auto_preview) {
+                const previewResponse = await this.client.makeRequest({
+                    method: 'POST',
+                    url: `/api/now/table/sys_update_set/${updateSetId}/preview`
+                });
+                // Check preview results
+                const previewProblems = await this.client.makeRequest({
+                    method: 'GET',
+                    url: '/api/now/table/sys_update_preview_problem',
+                    params: {
+                        sysparm_query: `update_set=${updateSetId}`,
+                        sysparm_limit: 100
+                    }
+                });
+                if (previewProblems.result && previewProblems.result.length > 0) {
+                    const problems = previewProblems.result.map((p) => `- ${p.type}: ${p.description}`).join('\n');
+                    if (auto_commit) {
+                        this.logger.warn('Preview found problems, skipping auto-commit', { problems });
+                    }
+                    return {
+                        success: true,
+                        message: 'XML imported and previewed with problems',
+                        update_set_id: updateSetId,
+                        update_set_name: updateSetName,
+                        preview_status: 'problems_found',
+                        problems: previewProblems.result,
+                        next_steps: [
+                            '1. Review preview problems in ServiceNow',
+                            '2. Resolve any issues',
+                            '3. Commit manually when ready'
+                        ]
+                    };
+                }
+                // Commit if clean and requested
+                if (auto_commit) {
+                    await this.client.makeRequest({
+                        method: 'POST',
+                        url: `/api/now/table/sys_update_set/${updateSetId}/commit`
+                    });
+                    return {
+                        success: true,
+                        message: '✅ XML Update Set imported, previewed, and committed successfully!',
+                        update_set_id: updateSetId,
+                        update_set_name: updateSetName,
+                        status: 'committed',
+                        flow_location: 'Flow Designer > Designer',
+                        next_steps: [
+                            '1. Navigate to Flow Designer',
+                            '2. Your flow should be visible in the list',
+                            '3. Open the flow to verify all components'
+                        ]
+                    };
+                }
+            }
+            // Return success without preview/commit
+            return {
+                success: true,
+                message: 'XML Update Set imported successfully',
+                update_set_id: updateSetId,
+                update_set_name: updateSetName,
+                status: 'imported',
+                next_steps: [
+                    '1. Navigate to System Update Sets > Local Update Sets',
+                    '2. Find your update set: ' + updateSetName,
+                    '3. Click Preview Update Set',
+                    '4. Review and commit when ready'
+                ]
+            };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            this.logger.error('XML deployment failed', { error: errorMsg, file: xml_file_path });
+            if (errorMsg.includes('ENOENT') || errorMsg.includes('no such file')) {
+                throw new Error(`XML file not found: ${xml_file_path}`);
+            }
+            throw new Error(`XML deployment failed: ${errorMsg}`);
+        }
+    }
     /**
      * Check if error is permission-related
      */