snow-flow 1.1.76 → 1.1.78

package/dist/memory/mcp-integration-example.js

@@ -0,0 +1,282 @@
+"use strict";
+/**
+ * Snow-Flow Memory System MCP Integration Example
+ * Shows how MCP tools integrate with the memory system
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const memory_client_js_1 = require("./memory-client.js");
+const logger_js_1 = require("../utils/logger.js");
+const logger = new logger_js_1.Logger('MCPIntegration');
+/**
+ * Example MCP tool that follows the memory integration pattern from MCP_ARCHITECTURE.md
+ */
+class WidgetCreatorMCP {
+    constructor(sessionId, agentId) {
+        this.memory = memory_client_js_1.MemoryClient.forAgent(agentId, 'widget-creator', sessionId);
+    }
+    /**
+     * Widget creation tool with full memory integration
+     */
+    async widget_create_structure(params) {
+        // 1. Read session context (as per MCP_ARCHITECTURE.md pattern)
+        const sessionContext = await this.memory.getSessionData();
+        const requirements = sessionContext.widget_requirements || {};
+        // Check for active agents
+        const activeAgents = await this.memory.getOperations().getActiveAgents(params.session_id);
+        logger.info('Active agents in session', {
+            count: activeAgents.length,
+            agents: activeAgents.map(a => ({ id: a.agent_id, type: a.agent_type, status: a.status }))
+        });
+        // 2. Execute ServiceNow operation (simulated)
+        const widgetResult = {
+            sys_id: `widget_${Date.now()}`,
+            name: params.widget_config.name,
+            title: params.widget_config.title,
+            status: 'created'
+        };
+        // 3. Update artifact tracking
+        if (params.update_memory) {
+            await this.memory.storeArtifact({
+                sys_id: widgetResult.sys_id,
+                type: 'widget',
+                name: params.widget_config.name,
+                description: `Widget created by ${params.agent_id}`,
+                status: 'created',
+                metadata: {
+                    category: params.widget_config.category,
+                    responsive: params.widget_config.responsive,
+                    created_from_requirements: requirements
+                }
+            });
+        }
+        // 4. Notify other agents via shared context
+        await this.memory.store({
+            key: 'widget_template_ready',
+            value: {
+                widget_sys_id: widgetResult.sys_id,
+                template_ready: true,
+                next_agent: 'ui_specialist'
+            }
+        });
+        // 5. Update coordination status
+        await this.memory.updateProgress(100);
+        // 6. Send handoff message
+        await this.memory.handoff({
+            to_agent: 'ui_specialist_001',
+            artifact_reference: widgetResult.sys_id,
+            data: {
+                styling_needed: true,
+                requirements: requirements.styling_requirements || {}
+            }
+        });
+        return widgetResult;
+    }
+    /**
+     * Performance-tracked operation example
+     */
+    async widget_generate_template(params) {
+        // Start performance tracking
+        const tracker = this.memory.trackOperation('generate_widget_template');
+        try {
+            // Simulate template generation
+            await new Promise(resolve => setTimeout(resolve, 50));
+            const template = {
+                html: '<div class="widget-container">...</div>',
+                type: params.template_type,
+                size: 1024
+            };
+            // Complete tracking with success
+            await tracker.complete(true, undefined, {
+                template_size: template.size,
+                template_type: params.template_type
+            });
+            return template;
+        }
+        catch (error) {
+            // Complete tracking with failure
+            await tracker.complete(false, error.message);
+            throw error;
+        }
+    }
+}
+/**
+ * Example Queen Agent coordination with memory
+ */
+class QueenCoordinationMCP {
+    constructor(sessionId) {
+        this.memory = memory_client_js_1.MemoryClient.forAgent('queen_001', 'queen', sessionId);
+    }
+    /**
+     * Monitor swarm progress using memory system
+     */
+    async queen_monitor_swarm(params) {
+        // Get session state from memory
+        const state = await this.memory.getSessionState();
+        // Analyze agent coordination
+        const agentStatus = state.agents.map(agent => ({
+            id: agent.agent_id,
+            type: agent.agent_type,
+            status: agent.status,
+            progress: agent.progress_percentage,
+            current_tool: agent.current_tool,
+            last_activity: agent.last_activity,
+            is_blocked: agent.status === 'blocked',
+            error: agent.error_state
+        }));
+        // Check for blocking issues
+        const blockingIssues = [];
+        // Check blocked agents
+        const blockedAgents = agentStatus.filter(a => a.is_blocked);
+        if (blockedAgents.length > 0) {
+            blockingIssues.push({
+                type: 'blocked_agents',
+                agents: blockedAgents,
+                recommendation: 'Check agent dependencies'
+            });
+        }
+        // Check failed deployments
+        const failedArtifacts = state.artifacts.filter(a => a.deployment_status === 'failed');
+        if (failedArtifacts.length > 0) {
+            blockingIssues.push({
+                type: 'failed_deployments',
+                artifacts: failedArtifacts,
+                recommendation: 'Review deployment errors and retry'
+            });
+        }
+        // Performance analysis
+        let performanceAnalysis = null;
+        if (params.detailed_metrics && state.performanceSummary) {
+            performanceAnalysis = {
+                total_operations: state.performanceSummary.total_operations,
+                avg_duration_ms: state.performanceSummary.avg_duration_ms,
+                success_rate: state.performanceSummary.success_rate,
+                slowest_operation_ms: state.performanceSummary.max_duration_ms,
+                recommendation: state.performanceSummary.avg_duration_ms > 100
+                    ? 'Performance below target (<100ms), consider optimization'
+                    : 'Performance meets requirements'
+            };
+        }
+        return {
+            session_id: params.session_id,
+            swarm_status: {
+                total_agents: state.agents.length,
+                active_agents: agentStatus.filter(a => a.status === 'active').length,
+                completed_agents: agentStatus.filter(a => a.status === 'completed').length,
+                blocked_agents: blockedAgents.length
+            },
+            agent_details: agentStatus,
+            artifacts_created: state.artifacts.length,
+            pending_messages: state.pendingMessages,
+            blocking_issues: blockingIssues,
+            performance_analysis: performanceAnalysis
+        };
+    }
+    /**
+     * Coordinate agent handoffs
+     */
+    async queen_coordinate_handoff(params) {
+        // Send coordination message
+        await this.memory.getOperations().sendMessage(this.memory.getSessionId(), 'queen_001', params.to_agent, 'coordination', {
+            handoff_from: params.from_agent,
+            artifact_type: params.artifact_type,
+            context: params.context_data,
+            coordination_time: new Date().toISOString()
+        });
+        // Update shared context for coordination
+        await this.memory.store({
+            key: `handoff_${params.from_agent}_to_${params.to_agent}`,
+            value: {
+                completed: true,
+                artifact_type: params.artifact_type,
+                timestamp: new Date().toISOString()
+            }
+        });
+    }
+}
+/**
+ * Example usage showing full integration
+ */
+async function demonstrateIntegration() {
+    logger.info('Starting MCP integration demonstration');
+    const sessionId = `demo_session_${Date.now()}`;
+    // Initialize MCPs
+    const widgetMCP = new WidgetCreatorMCP(sessionId, 'widget_creator_001');
+    const queenMCP = new QueenCoordinationMCP(sessionId);
+    try {
+        // Register agents
+        const widgetMemory = memory_client_js_1.MemoryClient.forAgent('widget_creator_001', 'widget-creator', sessionId);
+        const uiMemory = memory_client_js_1.MemoryClient.forAgent('ui_specialist_001', 'ui-specialist', sessionId);
+        await widgetMemory.register(['create_dashboard_widget']);
+        await uiMemory.register(['style_widget']);
+        // Store requirements in memory (simulating earlier analysis)
+        await widgetMemory.store({
+            key: 'widget_requirements',
+            value: {
+                type: 'dashboard',
+                data_sources: ['incident', 'problem'],
+                styling_requirements: {
+                    theme: 'modern',
+                    responsive: true
+                }
+            }
+        });
+        logger.info('Step 1: Widget creation with memory integration');
+        // Create widget using MCP tool
+        const widgetResult = await widgetMCP.widget_create_structure({
+            session_id: sessionId,
+            widget_config: {
+                name: 'incident_dashboard',
+                title: 'Incident Dashboard',
+                category: 'custom',
+                responsive: true
+            },
+            agent_id: 'widget_creator_001',
+            update_memory: true
+        });
+        logger.info('Widget created', widgetResult);
+        logger.info('Step 2: Generate template with performance tracking');
+        // Generate template
+        const template = await widgetMCP.widget_generate_template({
+            requirements: { charts: true, filters: true },
+            template_type: 'dashboard'
+        });
+        logger.info('Template generated', { size: template.size });
+        logger.info('Step 3: Queen monitors swarm progress');
+        // Queen monitors progress
+        const swarmStatus = await queenMCP.queen_monitor_swarm({
+            session_id: sessionId,
+            detailed_metrics: true
+        });
+        logger.info('Swarm status', JSON.stringify(swarmStatus, null, 2));
+        logger.info('Step 4: UI specialist checks for handoffs');
+        // UI specialist checks messages
+        const handoffs = await uiMemory.checkHandoffs();
+        logger.info('UI specialist received handoffs', handoffs);
+        logger.info('Step 5: Check performance metrics');
+        // Get performance stats
+        const perfStats = await widgetMemory.getPerformanceStats('generate_widget_template');
+        logger.info('Performance statistics', perfStats);
+        logger.info('Integration demonstration completed successfully!');
+    }
+    catch (error) {
+        logger.error('Integration demonstration failed', error);
+        throw error;
+    }
+    finally {
+        // Cleanup
+        memory_client_js_1.MemoryClient.shutdown();
+    }
+}
+// Run demonstration if called directly
+if (require.main === module) {
+    demonstrateIntegration()
+        .then(() => {
+        logger.info('MCP integration demonstration completed');
+        process.exit(0);
+    })
+        .catch((error) => {
+        logger.error('MCP integration demonstration failed', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=mcp-integration-example.js.map

package/dist/memory/mcp-integration-example.js.map

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

package/dist/memory/memory-client.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Snow-Flow Memory Client
+ * Simple API for agents to interact with the memory system
+ */
+import { SwarmMemory, SwarmMemoryConfig } from './swarm-memory.js';
+import { MemoryOperations } from './memory-operations.js';
+export interface MemoryClientConfig extends SwarmMemoryConfig {
+    sessionId?: string;
+    agentId?: string;
+    agentType?: string;
+}
+export interface MemoryStoreOptions {
+    key: string;
+    value: any;
+    expires?: Date;
+    permissions?: string[];
+}
+export interface MemoryRetrieveOptions {
+    key: string;
+    defaultValue?: any;
+}
+export interface ArtifactInfo {
+    sys_id: string;
+    type: 'widget' | 'flow' | 'script' | 'business_rule' | 'table' | 'catalog_item';
+    name: string;
+    description?: string;
+    status?: 'created' | 'tested' | 'deployed' | 'verified' | 'failed';
+    update_set_id?: string;
+    dependencies?: string[];
+    metadata?: any;
+}
+export interface AgentHandoff {
+    to_agent: string;
+    artifact_reference?: string;
+    data: any;
+}
+export interface PerformanceTracker {
+    complete(success: boolean, error?: string, metadata?: any): Promise<void>;
+}
+export declare class MemoryClient {
+    private memory;
+    private operations;
+    private logger;
+    private sessionId;
+    private agentId;
+    private agentType;
+    constructor(config?: MemoryClientConfig);
+    /**
+     * Store data in shared context
+     */
+    store(options: MemoryStoreOptions): Promise<void>;
+    /**
+     * Retrieve data from shared context
+     */
+    retrieve(options: MemoryRetrieveOptions): Promise<any>;
+    /**
+     * Get all context for current session
+     */
+    getSessionData(): Promise<Record<string, any>>;
+    /**
+     * Register current agent
+     */
+    register(assignedTasks?: string[]): Promise<void>;
+    /**
+     * Update agent progress
+     */
+    updateProgress(percentage: number, currentTool?: string): Promise<void>;
+    /**
+     * Mark agent as completed
+     */
+    complete(): Promise<void>;
+    /**
+     * Report agent error
+     */
+    reportError(error: string): Promise<void>;
+    /**
+     * Check if agent should wait for dependencies
+     */
+    checkDependencies(): Promise<boolean>;
+    /**
+     * Store ServiceNow artifact information
+     */
+    storeArtifact(artifact: ArtifactInfo): Promise<void>;
+    /**
+     * Update artifact status
+     */
+    updateArtifactStatus(sys_id: string, status: 'created' | 'tested' | 'deployed' | 'verified' | 'failed'): Promise<void>;
+    /**
+     * Find artifacts created in current session
+     */
+    findSessionArtifacts(type?: ArtifactInfo['type']): Promise<ArtifactInfo[]>;
+    /**
+     * Send handoff to another agent
+     */
+    handoff(handoff: AgentHandoff): Promise<void>;
+    /**
+     * Check for incoming handoffs
+     */
+    checkHandoffs(): Promise<Array<{
+        from: string;
+        data: any;
+        artifact_reference?: string;
+    }>>;
+    /**
+     * Send status update
+     */
+    sendStatus(status: string, details?: any): Promise<void>;
+    /**
+     * Report dependency ready
+     */
+    reportDependencyReady(dependent_agent: string, artifact_reference?: string): Promise<void>;
+    /**
+     * Start tracking an operation
+     */
+    trackOperation(operation: string): PerformanceTracker;
+    /**
+     * Get average performance for an operation
+     */
+    getPerformanceStats(operation: string): Promise<{
+        avgDuration: number;
+        successRate: number;
+        totalOperations: number;
+    } | null>;
+    /**
+     * Record successful deployment
+     */
+    recordDeployment(artifact_sys_id: string, type: 'create' | 'update' | 'test' | 'verify' | 'rollback', success?: boolean, error?: string): Promise<void>;
+    /**
+     * Get deployment history for an artifact
+     */
+    getDeploymentHistory(artifact_sys_id: string): Promise<Array<{
+        type: string;
+        success: boolean;
+        time: Date;
+        agent: string;
+        error?: string;
+    }>>;
+    /**
+     * Get current session ID
+     */
+    getSessionId(): string;
+    /**
+     * Get current agent ID
+     */
+    getAgentId(): string;
+    /**
+     * Get complete session state
+     */
+    getSessionState(): Promise<any>;
+    /**
+     * Clean up current session
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Get memory statistics
+     */
+    getStats(): Record<string, any>;
+    /**
+     * Run memory cleanup
+     */
+    runCleanup(): Promise<void>;
+    /**
+     * Get direct access to operations (for advanced use cases)
+     */
+    getOperations(): MemoryOperations;
+    /**
+     * Get direct access to database (for custom queries)
+     */
+    getDatabase(): SwarmMemory;
+    /**
+     * Create a memory client for an agent
+     */
+    static forAgent(agentId: string, agentType: string, sessionId?: string): MemoryClient;
+    /**
+     * Create a memory client for a session
+     */
+    static forSession(sessionId: string): MemoryClient;
+    /**
+     * Close all connections (call when shutting down)
+     */
+    static shutdown(): void;
+    private generateSessionId;
+}
+//# sourceMappingURL=memory-client.d.ts.map

package/dist/memory/memory-client.d.ts.map

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