snow-flow 1.1.76 → 1.1.77

package/CLAUDE.md

@@ -405,14 +405,24 @@ if (deployment.failed) {
 - `snow-flow swarm "<objective>"`: Start multi-agent swarm - één command voor alles!
 - `snow-flow sparc <mode> "<task>"`: Run specific SPARC mode
 
-## Enhanced Swarm Command (v1.1.41+)
-The swarm command now includes intelligent features that are **enabled by default**:
+## Enhanced Swarm Command with Queen Agent Orchestration (v1.1.75+)
+
+### 👑 Queen Agent Architecture
+The swarm command now uses Queen Agent orchestration, where a master coordinator spawns and manages specialized agents through Claude Code:
 
 ```bash
-# Simple usage - all intelligent features enabled!
+# Simple usage - Queen Agent handles everything!
 snow-flow swarm "create incident management dashboard"
 ```
 
+### What Happens:
+1. **Memory Initialization**: SQLite-based swarm memory system starts
+2. **Session Creation**: Unique session ID generated for tracking
+3. **Queen Agent Launch**: Master coordinator analyzes objective
+4. **Agent Spawning**: Specialized agents created via Task tool
+5. **Memory Coordination**: Agents communicate through shared memory
+6. **Progress Monitoring**: Real-time status updates via TodoWrite
+
 ### Default Settings (no flags needed):
 - ✅ `--smart-discovery` - Automatically discovers and reuses existing artifacts
 - ✅ `--live-testing` - Tests in real-time on your ServiceNow instance
@@ -430,15 +440,34 @@ snow-flow swarm "create global workflow" --auto-permissions
 # Disable specific features
 snow-flow swarm "test widget" --no-auto-deploy --no-live-testing
 
-# Full control
+# Full control with Queen Agent
 snow-flow swarm "complex integration" \
   --max-agents 8 \
   --strategy development \
-  --mode distributed \
+  --mode hierarchical \
   --parallel \
   --auto-permissions
 ```
 
+### Monitoring Swarm Progress:
+```bash
+# Check status of a running swarm
+snow-flow swarm-status <sessionId>
+
+# Continuously monitor progress
+snow-flow swarm-status <sessionId> --watch --interval 10
+
+# List recent swarm sessions
+snow-flow swarm-status
+```
+
+### Queen Agent Memory Patterns:
+The Queen Agent uses these memory keys for coordination:
+- `swarm_session_<sessionId>` - Main session data
+- `agent_<type>_progress` - Individual agent progress
+- `agent_<type>_complete` - Agent completion status
+- `swarm_session_<sessionId>_results` - Final results
+
 
 ## New MCP Tools (v1.1.44+)
 

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

@@ -0,0 +1,92 @@
+/**
+ * Base Agent Class
+ * Common functionality for all ServiceNow specialist agents
+ */
+import { Agent, AgentType, AgentMessage, ServiceNowArtifact } from '../queen/types';
+import { QueenMemorySystem } from '../queen/queen-memory';
+export interface AgentConfig {
+    id?: string;
+    type: AgentType;
+    capabilities: string[];
+    mcpTools: string[];
+    memoryPath?: string;
+    debugMode?: boolean;
+}
+export interface AgentResult {
+    success: boolean;
+    artifacts?: ServiceNowArtifact[];
+    message?: string;
+    error?: Error;
+    metadata?: Record<string, any>;
+}
+export declare abstract class BaseAgent implements Agent {
+    id: string;
+    type: AgentType;
+    status: Agent['status'];
+    task?: string;
+    capabilities: string[];
+    mcpTools: string[];
+    protected memory: QueenMemorySystem;
+    protected debugMode: boolean;
+    protected messageQueue: AgentMessage[];
+    constructor(config: AgentConfig);
+    /**
+     * Execute the agent's main task
+     * Must be implemented by each specific agent
+     */
+    abstract execute(instruction: string, context?: Record<string, any>): Promise<AgentResult>;
+    /**
+     * Validate agent can handle the task
+     * Can be overridden by specific agents
+     */
+    canHandle(instruction: string): Promise<boolean>;
+    /**
+     * Store artifact in shared memory for other agents
+     */
+    protected storeArtifact(artifact: ServiceNowArtifact): Promise<void>;
+    /**
+     * Retrieve artifact from shared memory
+     */
+    protected getArtifact(type: string, name: string): Promise<ServiceNowArtifact | null>;
+    /**
+     * Report progress to Queen Agent
+     */
+    protected reportProgress(message: string, percentage: number): Promise<void>;
+    /**
+     * Send message to another agent
+     */
+    protected sendMessage(to: string, type: AgentMessage['type'], content: any): void;
+    /**
+     * Retrieve messages for this agent
+     */
+    protected getMessages(): Promise<AgentMessage[]>;
+    /**
+     * Handle coordination with other agents
+     */
+    protected coordinateWith(agentType: AgentType, request: any): Promise<any>;
+    /**
+     * Log activity for learning
+     */
+    protected logActivity(action: string, success: boolean, details?: any): Promise<void>;
+    /**
+     * Update agent status
+     */
+    protected setStatus(status: Agent['status']): void;
+    /**
+     * Check if agent should work with another agent
+     */
+    protected shouldCoordinate(otherAgentType: AgentType): boolean;
+    /**
+     * Generate unique agent ID
+     */
+    private generateAgentId;
+    /**
+     * Get agent information
+     */
+    getInfo(): Record<string, any>;
+    /**
+     * Cleanup agent resources
+     */
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=base-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-agent.d.ts","sourceRoot":"","sources":["../../src/agents/base-agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG1D,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,8BAAsB,SAAU,YAAW,KAAK;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IAE1B,SAAS,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACpC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,YAAY,EAAE,YAAY,EAAE,CAAM;gBAEhC,MAAM,EAAE,WAAW;IAgB/B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAE1F;;;OAGG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQtD;;OAEG;cACa,aAAa,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1E;;OAEG;cACa,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAK3F;;OAEG;cACa,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAelF;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;IAkBjF;;OAEG;cACa,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAStD;;OAEG;cACa,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAwBhF;;OAEG;cACa,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3F;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI;IAUlD;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,cAAc,EAAE,SAAS,GAAG,OAAO;IAgB9D;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAW9B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAS/B"}

package/dist/agents/base-agent.js

@@ -0,0 +1,228 @@
+"use strict";
+/**
+ * Base Agent Class
+ * Common functionality for all ServiceNow specialist agents
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseAgent = void 0;
+const queen_memory_1 = require("../queen/queen-memory");
+const crypto = __importStar(require("crypto"));
+class BaseAgent {
+    constructor(config) {
+        this.messageQueue = [];
+        this.id = config.id || this.generateAgentId(config.type);
+        this.type = config.type;
+        this.status = 'idle';
+        this.capabilities = config.capabilities;
+        this.mcpTools = config.mcpTools;
+        this.debugMode = config.debugMode || false;
+        // Initialize memory system
+        this.memory = new queen_memory_1.QueenMemorySystem(config.memoryPath);
+        if (this.debugMode) {
+            console.log(`🤖 ${this.type} agent initialized with ID: ${this.id}`);
+        }
+    }
+    /**
+     * Validate agent can handle the task
+     * Can be overridden by specific agents
+     */
+    async canHandle(instruction) {
+        // Default implementation checks if instruction mentions agent capabilities
+        const lowerInstruction = instruction.toLowerCase();
+        return this.capabilities.some(capability => lowerInstruction.includes(capability.toLowerCase().split(' ')[0]));
+    }
+    /**
+     * Store artifact in shared memory for other agents
+     */
+    async storeArtifact(artifact) {
+        const key = `artifact_${artifact.type}_${artifact.name}`;
+        await this.memory.storeInContext(key, artifact);
+        if (this.debugMode) {
+            console.log(`📦 Stored artifact: ${key}`);
+        }
+    }
+    /**
+     * Retrieve artifact from shared memory
+     */
+    async getArtifact(type, name) {
+        const key = `artifact_${type}_${name}`;
+        return await this.memory.getFromContext(key);
+    }
+    /**
+     * Report progress to Queen Agent
+     */
+    async reportProgress(message, percentage) {
+        const progressKey = `progress_${this.id}`;
+        await this.memory.storeInContext(progressKey, {
+            agentId: this.id,
+            agentType: this.type,
+            message,
+            percentage,
+            timestamp: new Date()
+        });
+        if (this.debugMode) {
+            console.log(`📊 ${this.type}: ${message} (${percentage}%)`);
+        }
+    }
+    /**
+     * Send message to another agent
+     */
+    sendMessage(to, type, content) {
+        const message = {
+            from: this.id,
+            to,
+            type,
+            content,
+            timestamp: new Date()
+        };
+        // Store in shared memory for recipient
+        const messageKey = `message_${to}_${Date.now()}`;
+        this.memory.storeInContext(messageKey, message);
+        if (this.debugMode) {
+            console.log(`📨 Message sent from ${this.id} to ${to}: ${type}`);
+        }
+    }
+    /**
+     * Retrieve messages for this agent
+     */
+    async getMessages() {
+        const messagePrefix = `message_${this.id}_`;
+        const messages = [];
+        // This is a simplified implementation
+        // In a real system, we'd query the memory system more efficiently
+        return messages;
+    }
+    /**
+     * Handle coordination with other agents
+     */
+    async coordinateWith(agentType, request) {
+        const coordinationKey = `coordination_${this.id}_${agentType}_${Date.now()}`;
+        await this.memory.storeInContext(coordinationKey, {
+            from: this.id,
+            toType: agentType,
+            request,
+            timestamp: new Date()
+        });
+        // Wait for response (simplified)
+        const responseKey = `${coordinationKey}_response`;
+        let attempts = 0;
+        while (attempts < 30) { // 30 second timeout
+            const response = await this.memory.getFromContext(responseKey);
+            if (response) {
+                return response;
+            }
+            await new Promise(resolve => setTimeout(resolve, 1000));
+            attempts++;
+        }
+        throw new Error(`Coordination timeout with ${agentType}`);
+    }
+    /**
+     * Log activity for learning
+     */
+    async logActivity(action, success, details) {
+        const learningKey = `agent_activity_${this.type}_${action}`;
+        await this.memory.storeLearning(learningKey, JSON.stringify({
+            agentId: this.id,
+            action,
+            success,
+            details,
+            timestamp: new Date()
+        }), success ? 0.9 : 0.3);
+    }
+    /**
+     * Update agent status
+     */
+    setStatus(status) {
+        this.status = status;
+        const statusKey = `agent_status_${this.id}`;
+        this.memory.storeInContext(statusKey, {
+            agentId: this.id,
+            status,
+            timestamp: new Date()
+        });
+    }
+    /**
+     * Check if agent should work with another agent
+     */
+    shouldCoordinate(otherAgentType) {
+        // Define coordination rules
+        const coordinationRules = {
+            'widget-creator': ['tester', 'researcher', 'app-architect'],
+            'flow-builder': ['catalog-manager', 'tester', 'integration-specialist'],
+            'script-writer': ['tester', 'app-architect'],
+            'app-architect': ['widget-creator', 'script-writer', 'flow-builder'],
+            'integration-specialist': ['flow-builder', 'script-writer'],
+            'catalog-manager': ['flow-builder'],
+            'researcher': ['widget-creator', 'flow-builder', 'script-writer'],
+            'tester': ['widget-creator', 'flow-builder', 'script-writer']
+        };
+        return coordinationRules[this.type]?.includes(otherAgentType) || false;
+    }
+    /**
+     * Generate unique agent ID
+     */
+    generateAgentId(type) {
+        const timestamp = Date.now().toString(36);
+        const random = crypto.randomBytes(4).toString('hex');
+        return `${type}_${timestamp}_${random}`;
+    }
+    /**
+     * Get agent information
+     */
+    getInfo() {
+        return {
+            id: this.id,
+            type: this.type,
+            status: this.status,
+            capabilities: this.capabilities,
+            mcpTools: this.mcpTools,
+            task: this.task
+        };
+    }
+    /**
+     * Cleanup agent resources
+     */
+    async cleanup() {
+        // Clean up any resources
+        this.messageQueue = [];
+        this.status = 'idle';
+        if (this.debugMode) {
+            console.log(`🧹 ${this.type} agent ${this.id} cleaned up`);
+        }
+    }
+}
+exports.BaseAgent = BaseAgent;
+//# sourceMappingURL=base-agent.js.map

package/dist/agents/base-agent.js.map

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

package/dist/agents/coordinator.d.ts

@@ -0,0 +1,200 @@
+/**
+ * Agent Coordination System
+ * Manages inter-agent communication, task dependencies, and handoffs
+ * Integrates with SQLite memory for persistent coordination state
+ */
+import { EventEmitter } from 'eventemitter3';
+import { Agent, AgentMessage } from '../queen/types';
+import { QueenMemorySystem } from '../queen/queen-memory';
+export interface CoordinationContext {
+    sessionId: string;
+    objectiveId: string;
+    agents: Map<string, Agent>;
+    dependencies: Map<string, string[]>;
+    handoffs: Map<string, HandoffRequest>;
+    blockages: Map<string, BlockageInfo>;
+}
+export interface HandoffRequest {
+    id: string;
+    fromAgent: string;
+    toAgent: string;
+    artifactType: string;
+    artifactData: any;
+    status: 'pending' | 'accepted' | 'completed' | 'failed';
+    createdAt: Date;
+    completedAt?: Date;
+}
+export interface BlockageInfo {
+    agentId: string;
+    reason: string;
+    blockedTasks: string[];
+    dependencies: string[];
+    attemptedResolutions: string[];
+    createdAt: Date;
+}
+export interface CoordinationStrategy {
+    type: 'sequential' | 'parallel' | 'adaptive';
+    rules: CoordinationRule[];
+    fallbackStrategy?: string;
+}
+export interface CoordinationRule {
+    condition: string;
+    action: string;
+    priority: number;
+}
+export interface RecoveryStrategy {
+    errorType: string;
+    recoveryActions: RecoveryAction[];
+    maxRetries: number;
+}
+export interface RecoveryAction {
+    type: 'retry' | 'fallback' | 'reassign' | 'escalate';
+    config: Record<string, any>;
+}
+export declare class AgentCoordinator extends EventEmitter {
+    private memory;
+    private contexts;
+    private strategies;
+    private recoveryStrategies;
+    private messageQueue;
+    constructor(memory: QueenMemorySystem);
+    /**
+     * Create a new coordination context for an objective
+     */
+    createContext(sessionId: string, objectiveId: string): Promise<CoordinationContext>;
+    /**
+     * Register an agent with the coordinator
+     */
+    registerAgent(agent: Agent, objectiveId?: string): Promise<void>;
+    /**
+     * Manage task dependencies between agents
+     */
+    manageDependencies(objectiveId: string, taskId: string, dependencies: string[]): Promise<void>;
+    /**
+     * Coordinate handoff between agents
+     */
+    coordinateHandoff(fromAgentId: string, toAgentId: string, artifactType: string, artifactData: any): Promise<HandoffRequest>;
+    /**
+     * Handle agent blockage with recovery strategies
+     */
+    handleBlockage(agentId: string, reason: string, blockedTasks: string[]): Promise<void>;
+    /**
+     * Send message between agents
+     */
+    sendMessage(fromAgentId: string, toAgentId: string, messageType: AgentMessage['type'], content: any): Promise<void>;
+    /**
+     * Get pending messages for an agent
+     */
+    getAgentMessages(agentId: string): Promise<AgentMessage[]>;
+    /**
+     * Update handoff status
+     */
+    updateHandoffStatus(handoffId: string, status: HandoffRequest['status']): Promise<void>;
+    /**
+     * Get coordination status for an objective
+     */
+    getCoordinationStatus(objectiveId: string): Promise<{
+        agents: {
+            total: number;
+            active: number;
+            blocked: number;
+        };
+        handoffs: {
+            total: number;
+            pending: number;
+            completed: number;
+        };
+        dependencies: {
+            total: number;
+            satisfied: number;
+        };
+        blockages: number;
+    }>;
+    /**
+     * Apply coordination strategy
+     */
+    applyStrategy(objectiveId: string, strategyType: string): Promise<void>;
+    /**
+     * Terminate an agent
+     */
+    terminateAgent(agentId: string): Promise<void>;
+    /**
+     * Initialize default coordination strategies
+     */
+    private initializeDefaultStrategies;
+    /**
+     * Initialize recovery strategies for error handling
+     */
+    private initializeRecoveryStrategies;
+    /**
+     * Set up memory synchronization
+     */
+    private setupMemorySync;
+    /**
+     * Sync context to memory
+     */
+    private syncContextToMemory;
+    /**
+     * Check if dependencies are satisfied
+     */
+    private checkDependencySatisfaction;
+    /**
+     * Check if a specific dependency is satisfied
+     */
+    private isDependencySatisfied;
+    /**
+     * Find blocked dependencies
+     */
+    private findBlockedDependencies;
+    /**
+     * Attempt recovery for blocked agent
+     */
+    private attemptRecovery;
+    /**
+     * Find recovery strategy for error type
+     */
+    private findRecoveryStrategy;
+    /**
+     * Execute recovery action
+     */
+    private executeRecoveryAction;
+    /**
+     * Find available agent of specified type
+     */
+    private findAvailableAgent;
+    /**
+     * Reassign tasks from one agent to another
+     */
+    private reassignTasks;
+    /**
+     * Process pending messages for an agent
+     */
+    private processAgentMessages;
+    /**
+     * Evaluate strategy condition
+     */
+    private evaluateCondition;
+    /**
+     * Execute strategy action
+     */
+    private executeAction;
+    /**
+     * Generate unique ID
+     */
+    private generateId;
+    /**
+     * Get coordinator statistics
+     */
+    getStats(): Promise<{
+        activeContexts: number;
+        totalAgents: number;
+        activeHandoffs: number;
+        blockedAgents: number;
+        messagesInQueue: number;
+    }>;
+    /**
+     * Clean up completed contexts
+     */
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=coordinator.d.ts.map

package/dist/agents/coordinator.d.ts.map

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