snow-flow 1.1.91 → 1.1.93

package/dist/agents/base-agent.js

@@ -225,4 +225,3 @@ class BaseAgent {
     }
 }
 exports.BaseAgent = BaseAgent;
-//# sourceMappingURL=base-agent.js.map

package/dist/agents/coordinator.js

@@ -772,4 +772,3 @@ class AgentCoordinator extends eventemitter3_1.EventEmitter {
     }
 }
 exports.AgentCoordinator = AgentCoordinator;
-//# sourceMappingURL=coordinator.js.map

package/dist/agents/flow-builder-agent.js

@@ -533,4 +533,3 @@ class FlowBuilderAgent extends base_agent_1.BaseAgent {
     }
 }
 exports.FlowBuilderAgent = FlowBuilderAgent;
-//# sourceMappingURL=flow-builder-agent.js.map

package/dist/agents/index.js

@@ -58,4 +58,3 @@ exports.AGENT_CLASS_MAP = {
     'tester': () => Promise.resolve().then(() => __importStar(require('./test-agent'))).then(m => m.TestAgent),
     'security': () => Promise.resolve().then(() => __importStar(require('./security-agent'))).then(m => m.SecurityAgent)
 };
-//# sourceMappingURL=index.js.map

package/dist/agents/queen-403-handler.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Queen Agent 403 Error Handler
+ * Automatically analyzes and resolves ServiceNow permission issues using Gap Analysis Engine
+ */
+import { Logger } from '../utils/logger';
+export interface Permission403Context {
+    error: any;
+    operation: string;
+    tableName?: string;
+    artifactType?: string;
+    objective: string;
+}
+export declare class Queen403Handler {
+    private logger;
+    private mcpTools;
+    constructor(logger: Logger, mcpTools: any);
+    /**
+     * Handle 403 permission errors with intelligent analysis and resolution
+     */
+    handle403Error(context: Permission403Context): Promise<{
+        resolved: boolean;
+        analysis: any;
+        nextSteps: string[];
+        manualActions?: string[];
+    }>;
+    /**
+     * Create specific objective for ACL analysis
+     */
+    private createACLObjective;
+    /**
+     * Generate next steps based on analysis
+     */
+    private generateNextSteps;
+    /**
+     * Extract manual actions from gap analysis
+     */
+    private extractManualActions;
+    /**
+     * Log findings for Queen Agent awareness
+     */
+    private logFindings;
+    /**
+     * Generate fallback deployment configuration
+     */
+    generateFallbackConfig(context: Permission403Context): any;
+}
+//# sourceMappingURL=queen-403-handler.d.ts.map

package/dist/agents/queen-403-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queen-403-handler.d.ts","sourceRoot":"","sources":["../../src/agents/queen-403-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAIzC,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,GAAG,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAM;gBAEV,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG;IAKzC;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC;QAC3D,QAAQ,EAAE,OAAO,CAAC;QAClB,QAAQ,EAAE,GAAG,CAAC;QACd,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IAgDF;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0CzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAuBnB;;OAEG;IACH,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,GAAG;CAuB3D"}

package/dist/agents/queen-403-handler.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * Queen Agent 403 Error Handler
+ * Automatically analyzes and resolves ServiceNow permission issues using Gap Analysis Engine
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Queen403Handler = void 0;
+const gap_analysis_engine_1 = require("../intelligence/gap-analysis-engine");
+class Queen403Handler {
+    constructor(logger, mcpTools) {
+        this.logger = logger;
+        this.mcpTools = mcpTools;
+    }
+    /**
+     * Handle 403 permission errors with intelligent analysis and resolution
+     */
+    async handle403Error(context) {
+        this.logger.info('🚨 Queen Agent: 403 Permission Error detected - activating Gap Analysis');
+        // 1. Create specific objective for ACL analysis
+        const aclObjective = this.createACLObjective(context);
+        // 2. Run Gap Analysis specifically for permission issues
+        const gapAnalysis = await (0, gap_analysis_engine_1.analyzeGaps)(aclObjective, this.mcpTools, this.logger, {
+            autoPermissions: true,
+            environment: 'development',
+            enableAutomation: true,
+            includeManualGuides: true
+        });
+        // 3. Extract ACL-specific findings
+        const aclRequirements = gapAnalysis.requirements.filter(req => req.type === 'acl_rule' ||
+            req.type === 'user_role' ||
+            req.type === 'oauth_provider' ||
+            req.type === 'security_policy' ||
+            req.type === 'sys_property');
+        // 4. Check if any automatic fixes were applied
+        const autoFixed = gapAnalysis.automationResults.successful.filter(result => result.requirement.type === 'sys_property' &&
+            result.requirement.name?.includes('service_portal'));
+        // 5. Prepare next steps based on analysis
+        const nextSteps = this.generateNextSteps(context, gapAnalysis, aclRequirements);
+        // 6. Log findings for Queen Agent decision making
+        this.logFindings(aclRequirements, gapAnalysis);
+        return {
+            resolved: autoFixed.length > 0,
+            analysis: {
+                totalPermissionIssues: aclRequirements.length,
+                automaticallyFixed: autoFixed.length,
+                requiresManualWork: aclRequirements.filter(r => !r.automatable).length,
+                gapAnalysis: gapAnalysis
+            },
+            nextSteps,
+            manualActions: this.extractManualActions(gapAnalysis)
+        };
+    }
+    /**
+     * Create specific objective for ACL analysis
+     */
+    createACLObjective(context) {
+        const { tableName, artifactType, operation, objective } = context;
+        let aclObjective = `Fix 403 permission error for ${operation} on `;
+        if (tableName) {
+            aclObjective += `${tableName} table `;
+        }
+        else if (artifactType) {
+            aclObjective += `${artifactType} `;
+        }
+        aclObjective += `to complete: ${objective}`;
+        // Add specific context for sp_widget
+        if (tableName === 'sp_widget' || artifactType === 'widget') {
+            aclObjective += ' including Service Portal API access, OAuth scopes, and cross-scope permissions';
+        }
+        return aclObjective;
+    }
+    /**
+     * Generate next steps based on analysis
+     */
+    generateNextSteps(context, gapAnalysis, aclRequirements) {
+        const steps = [];
+        // 1. If automatic fixes were applied, suggest retry
+        if (gapAnalysis.automationResults.successful.length > 0) {
+            steps.push('🔄 Retry the deployment - automatic fixes have been applied');
+        }
+        // 2. For sp_widget specific issues
+        if (context.tableName === 'sp_widget') {
+            steps.push('🌐 Try deployment with global scope: scope_preference: "global"');
+            steps.push('📋 Ensure active Update Set: snow_ensure_active_update_set()');
+        }
+        // 3. For OAuth issues
+        const oauthIssues = aclRequirements.filter(r => r.type === 'oauth_provider');
+        if (oauthIssues.length > 0) {
+            steps.push('🔐 Check OAuth application settings in ServiceNow');
+            steps.push('🔧 Re-authenticate: snow-flow auth login');
+        }
+        // 4. For role issues
+        const roleIssues = aclRequirements.filter(r => r.type === 'user_role');
+        if (roleIssues.length > 0) {
+            const missingRoles = roleIssues.map(r => r.name).join(', ');
+            steps.push(`👤 Add missing roles: ${missingRoles}`);
+        }
+        // 5. For ACL rule issues
+        const aclRuleIssues = aclRequirements.filter(r => r.type === 'acl_rule');
+        if (aclRuleIssues.length > 0) {
+            steps.push('🛡️ Review ACL rules on the target table');
+            steps.push('🔍 Check for custom ACLs blocking API access');
+        }
+        return steps;
+    }
+    /**
+     * Extract manual actions from gap analysis
+     */
+    extractManualActions(gapAnalysis) {
+        const actions = [];
+        if (gapAnalysis.manualGuides && gapAnalysis.manualGuides.guides) {
+            gapAnalysis.manualGuides.guides.forEach((guide) => {
+                if (guide.category === 'security_permissions' ||
+                    guide.title.includes('ACL') ||
+                    guide.title.includes('Permission')) {
+                    actions.push(`📖 ${guide.title} (${guide.totalEstimatedTime})`);
+                    // Add first few steps as preview
+                    if (guide.instructions && guide.instructions.length > 0) {
+                        guide.instructions.slice(0, 2).forEach((instruction) => {
+                            actions.push(`   • ${instruction.title}`);
+                        });
+                    }
+                }
+            });
+        }
+        return actions;
+    }
+    /**
+     * Log findings for Queen Agent awareness
+     */
+    logFindings(aclRequirements, gapAnalysis) {
+        console.log('\n🧠 Queen Agent Permission Analysis Results:');
+        console.log('━'.repeat(50));
+        console.log(`\n📊 Permission Requirements Found: ${aclRequirements.length}`);
+        aclRequirements.forEach(req => {
+            const icon = req.automatable ? '🤖' : '👤';
+            console.log(`  ${icon} ${req.type}: ${req.name || req.description}`);
+        });
+        console.log(`\n✅ Automatic Fixes Applied: ${gapAnalysis.automationResults.successful.length}`);
+        gapAnalysis.automationResults.successful.forEach((result) => {
+            console.log(`  • ${result.requirement.name}: ${result.message}`);
+        });
+        console.log(`\n📋 Manual Actions Required: ${gapAnalysis.summary.requiresManualWork}`);
+        console.log('\n💡 Recommendations:');
+        gapAnalysis.nextSteps.recommendations.forEach((rec) => {
+            console.log(`  • ${rec}`);
+        });
+    }
+    /**
+     * Generate fallback deployment configuration
+     */
+    generateFallbackConfig(context) {
+        const fallbackConfig = {
+            retry_with_global_scope: true,
+            force_update_set: true,
+            permission_escalation: 'request'
+        };
+        // For widget deployments
+        if (context.tableName === 'sp_widget' || context.artifactType === 'widget') {
+            fallbackConfig.alternative_deployment = {
+                method: 'manual_steps',
+                generate_script: true,
+                instructions: [
+                    '1. Switch to Global application scope',
+                    '2. Navigate to Service Portal > Widgets',
+                    '3. Click New and paste the generated code',
+                    '4. Ensure you have an active Update Set'
+                ]
+            };
+        }
+        return fallbackConfig;
+    }
+}
+exports.Queen403Handler = Queen403Handler;

package/dist/agents/queen-403-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queen-403-handler.js","sourceRoot":"","sources":["../../src/agents/queen-403-handler.ts"],"names":[],"mappings":"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"}

package/dist/agents/queen-agent-example.js

@@ -238,4 +238,3 @@ if (require.main === module) {
         await demonstrateErrorRecovery();
     })();
 }
-//# sourceMappingURL=queen-agent-example.js.map

package/dist/agents/queen-agent.d.ts

@@ -1,32 +1,29 @@
 /**
- * Queen Agent Core
+ * Queen Agent Core with Enhanced 403 Error Handling
  * Master coordinator that analyzes objectives and spawns specialized agents
  * Works through Claude Code interface using TodoWrite for task coordination
+ * Now with intelligent 403 error handling using Gap Analysis Engine
  */
 import { EventEmitter } from 'eventemitter3';
-import { TodoItem, TodoStatus } from '../types/todo.types';
+import { TodoItem } from '../types/todo.types';
 import { Agent, TaskAnalysis } from '../queen/types';
-import { ParallelizationOpportunity } from '../queen/parallel-agent-engine';
 export interface QueenAgentConfig {
     memoryPath?: string;
     maxConcurrentAgents?: number;
     debugMode?: boolean;
     autoSpawn?: boolean;
     claudeCodeInterface?: boolean;
+    mcpTools?: any;
 }
 export interface QueenObjective {
     id: string;
     description: string;
-    context?: Record<string, any>;
     priority?: 'low' | 'medium' | 'high' | 'critical';
-    constraints?: {
-        maxDuration?: number;
-        requiredCapabilities?: string[];
-        forbiddenActions?: string[];
-    };
+    constraints?: string[];
+    metadata?: Record<string, any>;
 }
 export interface TodoCoordination {
-    taskId: string;
+    objectiveId: string;
     todos: TodoItem[];
     agentAssignments: Map<string, string>;
     dependencies: Map<string, string[]>;
@@ -35,15 +32,39 @@ export declare class QueenAgent extends EventEmitter {
     private memory;
     private coordinator;
     private parallelEngine;
+    private handler403;
     private config;
     private activeObjectives;
     private todoCoordinations;
     private activeAgents;
+    private logger;
     constructor(config?: QueenAgentConfig);
+    /**
+     * Update MCP tools configuration (useful when tools become available later)
+     */
+    updateMCPTools(mcpTools: any): void;
     /**
      * Analyze objective and create coordinated execution plan
      */
     analyzeObjective(objective: string | QueenObjective): Promise<TaskAnalysis>;
+    /**
+     * Handle deployment error with intelligent 403 detection and resolution
+     */
+    handleDeploymentError(error: any, context: {
+        objectiveId: string;
+        agentId?: string;
+        operation: string;
+        artifactType?: string;
+        tableName?: string;
+    }): Promise<boolean>;
+    /**
+     * Check if error is a 403 permission error
+     */
+    private is403Error;
+    /**
+     * Update todos with permission fix steps
+     */
+    private updateTodosWithPermissionFixes;
     /**
      * Spawn agents based on objective requirements with intelligent parallelization
      */
@@ -51,36 +72,27 @@ export declare class QueenAgent extends EventEmitter {
     /**
      * 🚀 NEW: Spawn parallel agents based on opportunities
      */
-    spawnParallelAgents(objectiveId: string, todoCoordination: TodoCoordination, opportunities: ParallelizationOpportunity[]): Promise<Agent[]>;
+    private spawnParallelAgents;
     /**
-     * Fallback: Spawn sequential agents (original behavior)
+     * Fallback to sequential agent spawning
      */
-    spawnSequentialAgents(objectiveId: string, todoCoordination: TodoCoordination, analysis: TaskAnalysis): Promise<Agent[]>;
+    private spawnSequentialAgents;
     /**
-     * Monitor and coordinate agent progress
+     * Spawn a specialized agent with optional specialization
      */
-    monitorProgress(objectiveId: string): Promise<{
-        overall: number;
-        byAgent: Map<string, number>;
-        blockingIssues: string[];
-        estimatedCompletion: Date;
-    }>;
+    private spawnSpecializedAgent;
     /**
-     * Make memory-driven decisions based on past patterns
+     * Analyze objective to determine requirements
      */
-    makeDecision(context: {
-        objective: string;
-        currentState: any;
-        options: string[];
-    }): Promise<{
-        decision: string;
-        reasoning: string;
-        confidence: number;
-    }>;
+    private performObjectiveAnalysis;
     /**
-     * Create TodoWrite coordination structure
+     * Create todo coordination structure for Claude Code interface
      */
     private createTodoCoordination;
+    /**
+     * Generate todos based on objective type
+     */
+    private generateTodosForObjective;
     /**
      * Create widget-specific todos
      */
@@ -89,6 +101,10 @@ export declare class QueenAgent extends EventEmitter {
      * Create flow-specific todos
      */
     private createFlowTodos;
+    /**
+     * Create application-specific todos
+     */
+    private createApplicationTodos;
     /**
      * Create script-specific todos
      */
@@ -102,93 +118,65 @@ export declare class QueenAgent extends EventEmitter {
      */
     private createGenericTodos;
     /**
-     * Set up logical dependencies between todos
-     */
-    private setupTodoDependencies;
-    /**
-     * 🚀 NEW: Assign todos to parallel agent with specializations
+     * Analyze todo dependencies
      */
-    private assignTodosToParallelAgent;
+    private analyzeTodoDependencies;
     /**
      * Assign todos to agent based on capabilities
      */
     private assignTodosToAgent;
     /**
-     * Perform deep analysis of objective
+     * Check if agent can handle specific todo
      */
-    private performObjectiveAnalysis;
+    private canAgentHandleTodo;
     /**
-     * Spawn a specialized agent with optional specialization
+     * Monitor agent progress through todo updates
      */
-    private spawnSpecializedAgent;
-    /**
-     * Get agent capabilities based on type
-     */
-    private getAgentCapabilities;
-    /**
-     * Get MCP tools available to agent type
-     */
-    private getAgentMcpTools;
-    /**
-     * Identify blocking issues in todo coordination
-     */
-    private identifyBlockingIssues;
-    /**
-     * Estimate completion time based on progress
-     */
-    private estimateCompletion;
-    /**
-     * Calculate score for decision option
-     */
-    private calculateOptionScore;
+    monitorProgress(objectiveId: string): Promise<{
+        overall: number;
+        byAgent: Map<string, number>;
+        blockingIssues: string[];
+        estimatedCompletion: Date;
+    }>;
     /**
-     * Generate reasoning for decision
+     * Make memory-driven decisions based on past patterns
      */
-    private generateDecisionReasoning;
+    makeDecision(context: {
+        objective: string;
+        currentState: any;
+        options: string[];
+    }): Promise<{
+        decision: string;
+        confidence: number;
+        reasoning: string;
+    }>;
     /**
-     * Set up event handlers for coordination
+     * Setup event handlers for coordination
      */
     private setupEventHandlers;
     /**
-     * Handle agent handoff events
+     * Check if more agents need to be spawned
      */
-    private handleAgentHandoff;
-    /**
-     * Handle agent blocked events
-     */
-    private handleAgentBlocked;
+    private checkAndSpawnAgents;
     /**
      * Handle coordination errors
      */
     private handleCoordinationError;
     /**
-     * Update todo status
+     * Identify blocking issues from todos
      */
-    private updateTodoStatus;
+    private identifyBlockingIssues;
     /**
-     * Generate unique ID
+     * Estimate completion time based on current progress
      */
-    private generateId;
+    private estimateCompletion;
     /**
-     * Get queen status
+     * Generate unique ID for entities
      */
-    getStatus(): Promise<{
-        activeObjectives: number;
-        activeAgents: number;
-        totalTodos: number;
-        completedTodos: number;
-        memoryStats: any;
-    }>;
+    private generateId;
     /**
-     * Shutdown queen agent
+     * Shutdown queen agent gracefully
      */
     shutdown(): Promise<void>;
 }
-export interface TodoItem {
-    id: string;
-    content: string;
-    status: TodoStatus;
-    priority: 'low' | 'medium' | 'high' | 'critical';
-}
-export type TodoStatus = 'pending' | 'in_progress' | 'completed' | 'cancelled';
 //# sourceMappingURL=queen-agent.d.ts.map

package/dist/agents/queen-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queen-agent.d.ts","sourceRoot":"","sources":["../../src/agents/queen-agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"queen-agent.d.ts","sourceRoot":"","sources":["../../src/agents/queen-agent.ts"],"names":[],"mappings":"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"}