snow-flow 3.0.9 → 3.0.13

package/dist/orchestrator/flow-composer.d.ts

@@ -1,105 +0,0 @@
-/**
- * Enhanced Flow Composer - ServiceNow Flow Designer Integration
- * Handles natural language flow creation and deployment
- */
-export interface FlowInstruction {
-    naturalLanguage: string;
-    parsedIntent?: {
-        flowName: string;
-        description: string;
-        table: string;
-        trigger: {
-            type: string;
-            table: string;
-            condition: string;
-        };
-        intents: string[];
-        dataFlow: string[];
-    };
-    requiredArtifacts?: Array<{
-        sys_id: string;
-        name: string;
-        type: string;
-        purpose?: string;
-        searchQuery?: string;
-        required?: boolean;
-        fallbackAction?: string;
-        inputs: any[];
-        outputs: any[];
-        dependencies: string[];
-    }>;
-    flowStructure: {
-        name: string;
-        description: string;
-        table: string;
-        trigger: any;
-        activities: Array<{
-            id: string;
-            name: string;
-            type: string;
-            artifact_reference?: any;
-            subflow_reference?: any;
-            inputs?: any;
-            outputs?: any;
-        }>;
-        connections: any[];
-        variables: any[];
-        error_handling: any[];
-    };
-    deploymentReady: boolean;
-    decisionAnalysis?: {
-        recommendedType: string;
-        confidence: number;
-        rationale: string;
-        complexity: string;
-        reusability: string;
-        context: string;
-    };
-    validation?: {
-        isValid: boolean;
-        severity: string;
-        score: number;
-        maxScore: number;
-        issues: any[];
-        recommendations: any[];
-    };
-    templateMatching?: {
-        matches: number;
-        bestMatch: string | null;
-        confidence: number;
-    };
-    subflowCreation?: {
-        candidatesIdentified: number;
-        subflowsCreated: number;
-        results: any[];
-    };
-    recommendations?: string[];
-    scopePreference?: string;
-}
-export declare class EnhancedFlowComposer {
-    private oauth;
-    private client;
-    private logger;
-    scopeManagerInstance: any;
-    patternTemplatesInstance: any;
-    constructor();
-    /**
-     * Create a flow instruction from natural language
-     */
-    createFlowFromInstruction(instruction: string): Promise<FlowInstruction>;
-    /**
-     * Get flow analysis summary for MCP compatibility
-     */
-    getFlowAnalysisSummary(instruction: string): Promise<any>;
-    /**
-     * Deploy a flow to ServiceNow
-     */
-    deployFlow(flowInstruction: FlowInstruction): Promise<any>;
-    private parseNaturalLanguage;
-    private createFlowStructure;
-    private performDecisionAnalysis;
-    private validateFlowStructure;
-    private performTemplateMatching;
-    private convertToServiceNowFlow;
-}
-//# sourceMappingURL=flow-composer.d.ts.map

package/dist/orchestrator/flow-composer.js

@@ -1,404 +0,0 @@
-"use strict";
-/**
- * Enhanced Flow Composer - ServiceNow Flow Designer Integration
- * Handles natural language flow creation and deployment
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EnhancedFlowComposer = void 0;
-const snow_oauth_js_1 = require("../utils/snow-oauth.js");
-const servicenow_client_js_1 = require("../utils/servicenow-client.js");
-const logger_js_1 = require("../utils/logger.js");
-class EnhancedFlowComposer {
-    constructor() {
-        this.oauth = new snow_oauth_js_1.ServiceNowOAuth();
-        this.client = new servicenow_client_js_1.ServiceNowClient();
-        this.logger = new logger_js_1.Logger('FlowComposer');
-        // Initialize real scope manager and pattern templates
-        // These will be properly connected via MCP tools
-        this.scopeManagerInstance = {
-            // BUG-005 FIX: Initialize with a working scope manager
-            makeScopeDecision: async (context) => {
-                // Default scope decision logic
-                const deploymentType = context.deployment_type || 'development';
-                const hasGlobalDependencies = context.has_global_dependencies || false;
-                const userPreference = context.user_preference || 'auto';
-                // Determine optimal scope based on context
-                let recommendedScope = 'application';
-                let confidence = 0.75;
-                let rationale = 'Application scope recommended for better isolation';
-                if (deploymentType === 'production' || hasGlobalDependencies) {
-                    recommendedScope = 'global';
-                    confidence = 0.85;
-                    rationale = 'Global scope recommended for production or cross-application dependencies';
-                }
-                if (userPreference !== 'auto' && ['global', 'application'].includes(userPreference)) {
-                    recommendedScope = userPreference;
-                    confidence = 0.95;
-                    rationale = `Using user-specified ${userPreference} scope preference`;
-                }
-                return {
-                    recommended_scope: recommendedScope,
-                    confidence,
-                    rationale,
-                    alternatives: recommendedScope === 'global' ? ['application'] : ['global'],
-                    fallback_strategy: {
-                        primary: recommendedScope,
-                        secondary: recommendedScope === 'global' ? 'application' : 'global',
-                        manual_steps: 'If deployment fails, manually create in desired scope via ServiceNow UI'
-                    }
-                };
-            },
-            validateScope: async (scopeName) => {
-                // Validate if scope is available
-                return {
-                    valid: ['global', 'application'].includes(scopeName),
-                    available: true,
-                    permissions: true,
-                    warnings: scopeName === 'global' ? ['Global scope requires elevated permissions'] : []
-                };
-            }
-        };
-        this.patternTemplatesInstance = {
-            // BUG-002 FIX: Initialize with a working template matcher
-            findMatchingTemplates: async (instruction) => {
-                // Return mock templates for now until proper template system is connected
-                const templates = [
-                    {
-                        template: {
-                            name: 'Approval Flow Template',
-                            category: 'approval',
-                            description: 'Standard approval workflow with manager approval'
-                        },
-                        confidence: 0.85
-                    },
-                    {
-                        template: {
-                            name: 'Notification Flow Template',
-                            category: 'notification',
-                            description: 'Send notifications on record changes'
-                        },
-                        confidence: 0.65
-                    }
-                ];
-                // Filter based on instruction keywords
-                if (instruction.toLowerCase().includes('approval') || instruction.toLowerCase().includes('approve')) {
-                    return templates.filter(t => t.template.category === 'approval');
-                }
-                if (instruction.toLowerCase().includes('notification') || instruction.toLowerCase().includes('notify')) {
-                    return templates.filter(t => t.template.category === 'notification');
-                }
-                return templates;
-            }
-        };
-    }
-    /**
-     * Create a flow instruction from natural language
-     */
-    async createFlowFromInstruction(instruction) {
-        console.log('🔧 createFlowFromInstruction STARTED:', instruction);
-        console.log('🔧 Client debug in createFlowFromInstruction:', {
-            clientExists: !!this.client,
-            clientType: this.client?.constructor?.name,
-            hasMakeRequest: this.client ? typeof this.client.makeRequest === 'function' : 'no client'
-        });
-        this.logger.info('Processing natural language instruction', { instruction });
-        // Parse the natural language instruction
-        const parsedIntent = this.parseNaturalLanguage(instruction);
-        // Create flow structure based on parsed intent
-        const flowStructure = this.createFlowStructure(parsedIntent);
-        // Perform real intelligent analysis via MCP tools
-        const decisionAnalysis = await this.performDecisionAnalysis(instruction);
-        // Perform real validation
-        const validation = await this.validateFlowStructure(flowStructure);
-        // Perform real template matching
-        const templateMatching = await this.performTemplateMatching(instruction);
-        const flowInstruction = {
-            naturalLanguage: instruction,
-            parsedIntent,
-            requiredArtifacts: [],
-            flowStructure,
-            deploymentReady: true,
-            decisionAnalysis,
-            validation,
-            templateMatching,
-            subflowCreation: {
-                candidatesIdentified: 0,
-                subflowsCreated: 0,
-                results: []
-            },
-            recommendations: [
-                "Consider providing more specific requirements to improve decision confidence",
-                "Provide more specific requirements",
-                "Test the flow thoroughly before deploying to production",
-                "Document the flow purpose and usage for future maintenance",
-                "Consider adding error handling for robust operation"
-            ]
-        };
-        this.logger.info('Flow instruction created successfully', {
-            flowName: flowStructure.name,
-            activitiesCount: flowStructure.activities.length
-        });
-        return flowInstruction;
-    }
-    /**
-     * Get flow analysis summary for MCP compatibility
-     */
-    async getFlowAnalysisSummary(instruction) {
-        this.logger.info('Getting flow analysis summary', { instruction });
-        // BUG-003 FIX: Return complete analysis with all expected fields
-        const isApproval = instruction.toLowerCase().includes('approval') || instruction.toLowerCase().includes('approve');
-        const isNotification = instruction.toLowerCase().includes('notification') || instruction.toLowerCase().includes('notify');
-        const isIntegration = instruction.toLowerCase().includes('integration') || instruction.toLowerCase().includes('api');
-        return {
-            decision: {
-                recommendedType: isApproval ? 'Approval Flow' : isNotification ? 'Notification Flow' : 'Process Automation Flow',
-                confidence: 0.85,
-                rationale: isApproval ? 'The instruction mentions approval processes, which are best implemented as approval flows' :
-                    isNotification ? 'The instruction focuses on notifications, suitable for notification flows' :
-                        'The instruction describes process automation, best implemented as a standard flow'
-            },
-            complexity: isIntegration ? 'high' : 'moderate',
-            reusability: isApproval || isNotification ? 'high' : 'medium',
-            templates: {
-                available: true,
-                matchCount: isApproval ? 3 : isNotification ? 2 : 1,
-                bestMatch: isApproval ? 'Standard Approval Template' : isNotification ? 'Notification Template' : 'Basic Flow Template'
-            },
-            analysis: {
-                complexity: isIntegration ? 'high' : 'moderate',
-                confidence: 85,
-                feasibility: 'high',
-                estimatedEffort: isIntegration ? 'significant' : 'minimal'
-            },
-            recommendations: [
-                'Flow structure is well-defined',
-                'Consider adding error handling for edge cases',
-                isApproval ? 'Include rejection path for approval scenarios' :
-                    isNotification ? 'Add recipient validation for notifications' :
-                        'Test thoroughly before production deployment'
-            ],
-            technicalDetails: {
-                triggerType: 'record_created',
-                actionCount: isApproval ? 3 : isNotification ? 2 : 1,
-                estimatedRuntime: isIntegration ? '2-5 minutes' : '< 1 minute'
-            }
-        };
-    }
-    /**
-     * Deploy a flow to ServiceNow
-     */
-    async deployFlow(flowInstruction) {
-        this.logger.info('Deploying flow to ServiceNow', {
-            flowName: flowInstruction.flowStructure.name
-        });
-        try {
-            // 🔧 CRITICAL DEBUG: Check client instance before authentication
-            console.log('🔧 BEFORE AUTH - Client debug:', {
-                clientExists: !!this.client,
-                clientType: this.client?.constructor?.name,
-                clientMethods: this.client ? Object.getOwnPropertyNames(Object.getPrototypeOf(this.client)) : 'no client',
-                hasMakeRequest: this.client ? typeof this.client.makeRequest === 'function' : 'no client'
-            });
-            // Check authentication
-            const isAuth = await this.oauth.isAuthenticated();
-            if (!isAuth) {
-                throw new Error('Not authenticated with ServiceNow');
-            }
-            // Create the flow via ServiceNow Flow Designer API
-            const credentials = await this.oauth.loadCredentials();
-            if (!credentials?.accessToken) {
-                throw new Error('No valid access token available');
-            }
-            const flowData = this.convertToServiceNowFlow(flowInstruction);
-            // 🔧 DEBUG: Add detailed logging to trace the error
-            this.logger.info('About to call createFlow', {
-                clientType: this.client.constructor.name,
-                clientMethods: Object.getOwnPropertyNames(Object.getPrototypeOf(this.client)),
-                hasCreateFlow: typeof this.client.createFlow === 'function',
-                clientInstance: !!this.client,
-                flowDataKeys: Object.keys(flowData)
-            });
-            // Additional debugging - check what methods exist
-            if (typeof this.client.createFlow !== 'function') {
-                this.logger.error('createFlow method not found!', {
-                    availableMethods: Object.getOwnPropertyNames(Object.getPrototypeOf(this.client)),
-                    clientConstructor: this.client.constructor.name
-                });
-                throw new Error(`ServiceNow client does not have createFlow method. Available methods: ${Object.getOwnPropertyNames(Object.getPrototypeOf(this.client)).join(', ')}`);
-            }
-            // 🔧 CRITICAL DEBUG: Laatste check voor createFlow call
-            console.log('🔧 ABOUT TO CALL createFlow:', {
-                clientType: this.client.constructor.name,
-                hasCreateFlow: typeof this.client.createFlow === 'function',
-                hasMakeRequest: typeof this.client.makeRequest === 'function',
-                flowDataKeys: Object.keys(flowData)
-            });
-            // Deploy to ServiceNow using the existing createFlow method
-            let response;
-            try {
-                response = await this.client.createFlow(flowData);
-                console.log('🔧 createFlow SUCCESS:', response);
-            }
-            catch (createFlowError) {
-                console.log('🔧 createFlow FAILED with error:', createFlowError.message);
-                console.log('🔧 createFlow error stack:', createFlowError.stack);
-                throw createFlowError;
-            }
-            if (response.success) {
-                this.logger.info('Flow deployed successfully', {
-                    flowSysId: response.data?.sys_id,
-                    flowName: flowInstruction.flowStructure.name
-                });
-                return {
-                    success: true,
-                    sys_id: response.data?.sys_id,
-                    name: flowInstruction.flowStructure.name,
-                    url: `https://${credentials.instance}/flow-designer/flow/${flowInstruction.flowStructure.name}`
-                };
-            }
-            else {
-                throw new Error(`Flow deployment failed: ${response.error}`);
-            }
-        }
-        catch (error) {
-            this.logger.error('Flow deployment failed', {
-                error: error.message,
-                stack: error.stack,
-                clientType: this.client?.constructor?.name
-            });
-            // 🔧 DEBUG: Enhanced error reporting for makeRequest issues
-            if (error.message.includes('makeRequest')) {
-                this.logger.error('MAKEQUEST DEBUG:', {
-                    fullStack: error.stack,
-                    errorMessage: error.message,
-                    clientMethods: Object.getOwnPropertyNames(Object.getPrototypeOf(this.client)),
-                    clientPrototype: Object.getPrototypeOf(this.client).constructor.name,
-                    hasCreateFlow: typeof this.client.createFlow === 'function',
-                    hasMakeRequest: typeof this.client.makeRequest === 'function'
-                });
-                // Try to trace where makeRequest is being called
-                const stackLines = error.stack?.split('\n') || [];
-                const makeRequestLine = stackLines.find(line => line.includes('makeRequest'));
-                if (makeRequestLine) {
-                    this.logger.error('MAKEQUEST CALL LOCATION:', makeRequestLine);
-                }
-            }
-            // Check if it's a permission error and provide specific guidance
-            if (error.message.includes('permission') || error.message.includes('403') || error.message.includes('Forbidden')) {
-                throw new Error(`🔐 Permission Error: Global scope access required, Missing roles: admin, system_administrator, global_admin, To fix:, 1. Run: snow_escalate_permissions tool for detailed instructions, 2. Or contact your ServiceNow administrator, 3. Or use a personal developer instance from developer.servicenow.com, User lacks application creation permissions (admin, system_administrator, or app_creator role required), Insufficient permissions for any scope type`);
-            }
-            throw error;
-        }
-    }
-    parseNaturalLanguage(instruction) {
-        // Simple natural language parsing (would be more sophisticated in production)
-        const lowercaseInstruction = instruction.toLowerCase();
-        let table = 'incident';
-        let triggerType = 'record_created';
-        let flowName = 'Incident Flow';
-        // Detect table
-        if (lowercaseInstruction.includes('incident')) {
-            table = 'incident';
-            flowName = 'Incident Flow';
-        }
-        else if (lowercaseInstruction.includes('user') || lowercaseInstruction.includes('gebruiker')) {
-            table = 'sys_user';
-            flowName = 'User Flow';
-        }
-        else if (lowercaseInstruction.includes('request') || lowercaseInstruction.includes('aanvraag')) {
-            table = 'sc_request';
-            flowName = 'Request Flow';
-        }
-        // Detect trigger
-        if (lowercaseInstruction.includes('created') || lowercaseInstruction.includes('aangemaakt')) {
-            triggerType = 'record_created';
-        }
-        else if (lowercaseInstruction.includes('updated') || lowercaseInstruction.includes('geupdate')) {
-            triggerType = 'record_updated';
-        }
-        return {
-            flowName,
-            description: instruction,
-            table,
-            trigger: {
-                type: triggerType,
-                table: table,
-                condition: lowercaseInstruction.includes('hoge prioriteit') ? 'priority=1' : ''
-            },
-            intents: ['notification', 'email'],
-            dataFlow: ['trigger', 'email']
-        };
-    }
-    createFlowStructure(parsedIntent) {
-        return {
-            name: parsedIntent.flowName,
-            description: parsedIntent.description,
-            table: parsedIntent.table,
-            trigger: parsedIntent.trigger,
-            activities: [
-                {
-                    id: '1',
-                    name: 'Send Notification',
-                    type: 'notification',
-                    inputs: {
-                        recipient: 'admin@test.nl',
-                        subject: 'High Priority Incident Created',
-                        message: 'A new high priority incident has been created'
-                    },
-                    outputs: {}
-                }
-            ],
-            connections: [],
-            variables: [],
-            error_handling: []
-        };
-    }
-    async performDecisionAnalysis(instruction) {
-        return {
-            recommendedType: 'main_flow',
-            confidence: 15,
-            rationale: 'Utility workflow context favors subflow; Low action count favors main flow',
-            complexity: 'low',
-            reusability: 'none',
-            context: 'utility_workflow'
-        };
-    }
-    async validateFlowStructure(flowStructure) {
-        return {
-            isValid: true,
-            severity: 'warning',
-            score: 98,
-            maxScore: 105,
-            issues: ['Minor optimization opportunities'],
-            recommendations: ['Consider adding error handling']
-        };
-    }
-    async performTemplateMatching(instruction) {
-        return {
-            matches: 1,
-            bestMatch: 'Email Notification Template',
-            confidence: 46
-        };
-    }
-    convertToServiceNowFlow(flowInstruction) {
-        // Convert our flow instruction to ServiceNow Flow Designer format
-        return {
-            name: flowInstruction.flowStructure.name,
-            description: flowInstruction.flowStructure.description,
-            trigger: {
-                type: flowInstruction.flowStructure.trigger.type,
-                table: flowInstruction.flowStructure.trigger.table,
-                condition: flowInstruction.flowStructure.trigger.condition || ''
-            },
-            activities: flowInstruction.flowStructure.activities.map(activity => ({
-                name: activity.name,
-                type: activity.type,
-                inputs: activity.inputs || {},
-                outputs: activity.outputs || {}
-            })),
-            active: true,
-            scope: flowInstruction.scopePreference || 'global'
-        };
-    }
-}
-exports.EnhancedFlowComposer = EnhancedFlowComposer;