snow-flow 1.1.76 → 1.1.78

package/dist/memory/swarm-memory.js

@@ -0,0 +1,378 @@
+"use strict";
+/**
+ * Snow-Flow Swarm Memory System
+ * Core SQLite database management for agent coordination
+ *
+ * This module provides the foundation for cross-agent communication,
+ * artifact tracking, and performance monitoring.
+ */
+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.SwarmMemory = void 0;
+const logger_js_1 = require("../utils/logger.js");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+let Database;
+try {
+    Database = require('better-sqlite3');
+}
+catch (error) {
+    console.error('Failed to load better-sqlite3:', error);
+    throw new Error('better-sqlite3 module is required. Please run: npm install better-sqlite3');
+}
+class SwarmMemory {
+    constructor(config = {}) {
+        this.migrationVersion = 1;
+        this.logger = new logger_js_1.Logger('SwarmMemory');
+        this.config = config;
+        // Ensure memory directory exists
+        if (!config.inMemory && !config.dbPath) {
+            const memoryDir = path.join(process.cwd(), '.claude-flow', 'memory');
+            if (!fs.existsSync(memoryDir)) {
+                fs.mkdirSync(memoryDir, { recursive: true });
+            }
+            config.dbPath = path.join(memoryDir, 'swarm-memory.db');
+        }
+        // Initialize database
+        if (config.inMemory) {
+            this.db = new Database(':memory:');
+            this.logger.info('Initialized in-memory database');
+        }
+        else {
+            this.db = new Database(config.dbPath);
+            this.logger.info('Initialized file-based database', { path: config.dbPath });
+        }
+        // Configure database for performance
+        this.configureDatabase();
+        // Run migrations
+        if (config.autoMigrate !== false) {
+            this.migrate();
+        }
+    }
+    configureDatabase() {
+        // Enable foreign keys for data integrity
+        this.db.pragma('foreign_keys = ON');
+        // Optimize for concurrent reads
+        this.db.pragma('journal_mode = WAL');
+        // Increase cache size for better performance
+        this.db.pragma('cache_size = 10000');
+        // Optimize for fast queries
+        this.db.pragma('synchronous = NORMAL');
+        if (this.config.verbose) {
+            this.logger.info('Database configured for optimal performance');
+        }
+    }
+    migrate() {
+        this.logger.info('Running database migrations');
+        // Check current migration version
+        const userVersion = this.db.pragma('user_version', { simple: true });
+        if (userVersion < this.migrationVersion) {
+            this.logger.info(`Migrating from version ${userVersion} to ${this.migrationVersion}`);
+            try {
+                this.db.transaction(() => {
+                    // Create all tables as specified in MCP_ARCHITECTURE.md
+                    this.createTables();
+                    // Create indexes for performance
+                    this.createIndexes();
+                    // Update migration version
+                    this.db.pragma(`user_version = ${this.migrationVersion}`);
+                })();
+                this.logger.info('Migration completed successfully');
+            }
+            catch (error) {
+                this.logger.error('Migration failed', error);
+                throw new Error(`Database migration failed: ${error.message}`);
+            }
+        }
+    }
+    createTables() {
+        // Agent coordination and communication
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS agent_coordination (
+        session_id TEXT NOT NULL,
+        agent_id TEXT NOT NULL,
+        agent_type TEXT NOT NULL,
+        status TEXT NOT NULL CHECK (status IN ('spawned', 'active', 'blocked', 'completed', 'failed')),
+        assigned_tasks TEXT NOT NULL,
+        progress_percentage INTEGER DEFAULT 0 CHECK (progress_percentage >= 0 AND progress_percentage <= 100),
+        last_activity TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        current_tool TEXT,
+        error_state TEXT,
+        PRIMARY KEY (session_id, agent_id)
+      );
+    `);
+        // ServiceNow artifact tracking
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS servicenow_artifacts (
+        sys_id TEXT PRIMARY KEY,
+        artifact_type TEXT NOT NULL CHECK (artifact_type IN ('widget', 'flow', 'script', 'business_rule', 'table', 'catalog_item')),
+        name TEXT NOT NULL,
+        description TEXT,
+        created_by_agent TEXT NOT NULL,
+        session_id TEXT NOT NULL,
+        deployment_status TEXT NOT NULL CHECK (deployment_status IN ('created', 'tested', 'deployed', 'verified', 'failed')),
+        update_set_id TEXT,
+        dependencies TEXT, -- JSON array of dependent artifacts
+        metadata TEXT, -- JSON blob of artifact-specific data
+        created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
+      );
+    `);
+        // Inter-agent communication
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS agent_messages (
+        id TEXT PRIMARY KEY,
+        session_id TEXT NOT NULL,
+        from_agent TEXT NOT NULL,
+        to_agent TEXT NOT NULL,
+        message_type TEXT NOT NULL CHECK (message_type IN ('handoff', 'dependency_ready', 'error', 'status_update', 'coordination')),
+        content TEXT NOT NULL,
+        artifact_reference TEXT,
+        timestamp TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        processed BOOLEAN DEFAULT FALSE
+      );
+    `);
+        // Shared context between agents
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS shared_context (
+        session_id TEXT NOT NULL,
+        context_key TEXT NOT NULL,
+        context_value TEXT NOT NULL,
+        created_by_agent TEXT NOT NULL,
+        expires_at TIMESTAMP,
+        access_permissions TEXT, -- JSON array of agent types that can access
+        created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        PRIMARY KEY (session_id, context_key)
+      );
+    `);
+        // Deployment tracking
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS deployment_history (
+        id TEXT PRIMARY KEY,
+        session_id TEXT NOT NULL,
+        artifact_sys_id TEXT NOT NULL,
+        deployment_type TEXT NOT NULL CHECK (deployment_type IN ('create', 'update', 'test', 'verify', 'rollback')),
+        success BOOLEAN NOT NULL,
+        deployment_time TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        agent_id TEXT NOT NULL,
+        error_details TEXT,
+        rollback_available BOOLEAN DEFAULT FALSE
+      );
+    `);
+        // Agent dependencies and handoffs
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS agent_dependencies (
+        session_id TEXT NOT NULL,
+        agent_id TEXT NOT NULL,
+        depends_on_agent TEXT NOT NULL,
+        dependency_type TEXT NOT NULL CHECK (dependency_type IN ('artifact_ready', 'approval_needed', 'data_available', 'task_complete')),
+        artifact_reference TEXT,
+        status TEXT NOT NULL CHECK (status IN ('pending', 'satisfied', 'blocked', 'failed')),
+        created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        satisfied_at TIMESTAMP,
+        PRIMARY KEY (session_id, agent_id, depends_on_agent)
+      );
+    `);
+        // Performance metrics
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS performance_metrics (
+        id TEXT PRIMARY KEY,
+        session_id TEXT NOT NULL,
+        agent_id TEXT NOT NULL,
+        operation_name TEXT NOT NULL,
+        duration_ms INTEGER NOT NULL CHECK (duration_ms >= 0),
+        success BOOLEAN NOT NULL,
+        error_message TEXT,
+        timestamp TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        metadata TEXT -- JSON blob for additional metrics
+      );
+    `);
+    }
+    createIndexes() {
+        // Indexes for agent_coordination
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_agent_coordination_status 
+      ON agent_coordination(status);
+      
+      CREATE INDEX IF NOT EXISTS idx_agent_coordination_session 
+      ON agent_coordination(session_id);
+    `);
+        // Indexes for servicenow_artifacts
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_artifacts_session 
+      ON servicenow_artifacts(session_id);
+      
+      CREATE INDEX IF NOT EXISTS idx_artifacts_type 
+      ON servicenow_artifacts(artifact_type);
+      
+      CREATE INDEX IF NOT EXISTS idx_artifacts_status 
+      ON servicenow_artifacts(deployment_status);
+    `);
+        // Indexes for agent_messages
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_messages_session 
+      ON agent_messages(session_id);
+      
+      CREATE INDEX IF NOT EXISTS idx_messages_to_agent 
+      ON agent_messages(to_agent, processed);
+      
+      CREATE INDEX IF NOT EXISTS idx_messages_timestamp 
+      ON agent_messages(timestamp);
+    `);
+        // Indexes for shared_context
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_context_session 
+      ON shared_context(session_id);
+      
+      CREATE INDEX IF NOT EXISTS idx_context_expires 
+      ON shared_context(expires_at);
+    `);
+        // Indexes for performance_metrics
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_metrics_session 
+      ON performance_metrics(session_id);
+      
+      CREATE INDEX IF NOT EXISTS idx_metrics_agent 
+      ON performance_metrics(agent_id);
+      
+      CREATE INDEX IF NOT EXISTS idx_metrics_timestamp 
+      ON performance_metrics(timestamp);
+    `);
+    }
+    /**
+     * Get the underlying database instance for direct queries
+     */
+    getDatabase() {
+        return this.db;
+    }
+    /**
+     * Prepare a statement for repeated execution
+     */
+    prepare(sql) {
+        return this.db.prepare(sql);
+    }
+    /**
+     * Execute a query and return all results
+     */
+    all(sql, params) {
+        const stmt = this.db.prepare(sql);
+        return params ? stmt.all(...params) : stmt.all();
+    }
+    /**
+     * Execute a query and return the first result
+     */
+    get(sql, params) {
+        const stmt = this.db.prepare(sql);
+        return params ? stmt.get(...params) : stmt.get();
+    }
+    /**
+     * Execute a statement that doesn't return data
+     */
+    run(sql, params) {
+        const stmt = this.db.prepare(sql);
+        return params ? stmt.run(...params) : stmt.run();
+    }
+    /**
+     * Execute multiple statements in a transaction
+     */
+    transaction(fn) {
+        const transaction = this.db.transaction(fn);
+        return transaction();
+    }
+    /**
+     * Clean up expired data
+     */
+    cleanup() {
+        this.logger.info('Running memory cleanup');
+        this.transaction(() => {
+            // Remove expired context
+            this.run(`
+        DELETE FROM shared_context 
+        WHERE expires_at IS NOT NULL AND expires_at < datetime('now')
+      `);
+            // Archive old messages
+            const thirtyDaysAgo = new Date();
+            thirtyDaysAgo.setDate(thirtyDaysAgo.getDate() - 30);
+            this.run(`
+        DELETE FROM agent_messages 
+        WHERE processed = 1 AND timestamp < ?
+      `, [thirtyDaysAgo.toISOString()]);
+            // Archive old performance metrics
+            this.run(`
+        DELETE FROM performance_metrics 
+        WHERE timestamp < ?
+      `, [thirtyDaysAgo.toISOString()]);
+        });
+        // Optimize database
+        this.db.pragma('optimize');
+        this.logger.info('Memory cleanup completed');
+    }
+    /**
+     * Get database statistics
+     */
+    getStats() {
+        const stats = {};
+        const tables = [
+            'agent_coordination',
+            'servicenow_artifacts',
+            'agent_messages',
+            'shared_context',
+            'deployment_history',
+            'agent_dependencies',
+            'performance_metrics'
+        ];
+        for (const table of tables) {
+            const count = this.get(`SELECT COUNT(*) as count FROM ${table}`)?.count || 0;
+            stats[table] = count;
+        }
+        // Add database size
+        const pageCount = this.db.pragma('page_count', { simple: true });
+        const pageSize = this.db.pragma('page_size', { simple: true });
+        if (pageCount && pageSize) {
+            stats.database_size_bytes = pageCount * pageSize;
+        }
+        return stats;
+    }
+    /**
+     * Close the database connection
+     */
+    close() {
+        this.logger.info('Closing database connection');
+        this.db.close();
+    }
+}
+exports.SwarmMemory = SwarmMemory;
+//# sourceMappingURL=swarm-memory.js.map

package/dist/memory/swarm-memory.js.map

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

package/dist/monitoring/performance-tracker.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Snow-Flow Performance Monitoring System
+ * Real-time metrics collection and analysis
+ */
+import { EventEmitter } from 'events';
+import { MemorySystem } from '../memory/memory-system';
+export interface PerformanceMetric {
+    id: string;
+    operation: string;
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+    success: boolean;
+    metadata: Record<string, any>;
+    sessionId?: string;
+    agentId?: string;
+    resourceUsage?: ResourceUsage;
+    error?: string;
+}
+export interface ResourceUsage {
+    cpuUsage: number;
+    memoryUsage: number;
+    heapUsed: number;
+    heapTotal: number;
+    external: number;
+    arrayBuffers: number;
+}
+export interface AggregateMetrics {
+    operation: string;
+    count: number;
+    successCount: number;
+    failureCount: number;
+    averageDuration: number;
+    minDuration: number;
+    maxDuration: number;
+    percentile95: number;
+    percentile99: number;
+    errorRate: number;
+    throughput: number;
+}
+export interface SessionMetrics {
+    sessionId: string;
+    startTime: Date;
+    endTime?: Date;
+    duration?: number;
+    operationCount: number;
+    successCount: number;
+    failureCount: number;
+    agentCount: number;
+    artifactCount: number;
+    averageOperationTime: number;
+    resourceUsage: ResourceUsage[];
+}
+export interface PerformanceReport {
+    timestamp: Date;
+    period: string;
+    summary: {
+        totalOperations: number;
+        successRate: number;
+        averageResponseTime: number;
+        peakConcurrency: number;
+        errorRate: number;
+    };
+    operationMetrics: AggregateMetrics[];
+    sessionMetrics: SessionMetrics[];
+    bottlenecks: Bottleneck[];
+    recommendations: string[];
+}
+export interface Bottleneck {
+    operation: string;
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    impact: string;
+    occurrences: number;
+    averageDelay: number;
+    recommendation: string;
+}
+interface TrackerConfig {
+    memory: MemorySystem;
+    config: {
+        sampleRate: number;
+        metricsRetention: number;
+        aggregationInterval: number;
+    };
+}
+export declare class PerformanceTracker extends EventEmitter {
+    private memory;
+    private logger;
+    private config;
+    private activeOperations;
+    private metricsBuffer;
+    private aggregationTimer?;
+    private initialized;
+    constructor(options: TrackerConfig);
+    /**
+     * Initialize the performance tracker
+     */
+    initialize(): Promise<void>;
+    /**
+     * Start tracking an operation
+     */
+    startOperation(operation: string, metadata?: Record<string, any>): Promise<string>;
+    /**
+     * End tracking an operation
+     */
+    endOperation(operationId: string, result: {
+        success: boolean;
+        error?: string;
+        metadata?: any;
+    }): Promise<void>;
+    /**
+     * Track a complete operation (convenience method)
+     */
+    trackOperation<T>(operation: string, metadata: Record<string, any>, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Get metrics for a specific session
+     */
+    getSessionMetrics(sessionId: string): Promise<SessionMetrics>;
+    /**
+     * Get aggregate metrics for an operation
+     */
+    getAggregateMetrics(operation: string, timeframe?: number): Promise<AggregateMetrics>;
+    /**
+     * Generate performance report
+     */
+    generateReport(period?: 'hour' | 'day' | 'week' | 'month'): Promise<PerformanceReport>;
+    /**
+     * Identify performance bottlenecks
+     */
+    identifyBottlenecks(metrics: PerformanceMetric[]): Promise<Bottleneck[]>;
+    /**
+     * Shutdown the tracker
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Private helper methods
+     */
+    private createPerformanceTables;
+    private startAggregation;
+    private startResourceMonitoring;
+    private captureResourceUsage;
+    private calculateResourceDelta;
+    private flushMetrics;
+    private aggregateMetrics;
+    private cleanupOldMetrics;
+    private checkPerformanceThresholds;
+    private generateMetricId;
+    private calculatePercentile;
+    private calculateVariance;
+    private calculatePeakConcurrency;
+    private countSessionArtifacts;
+    private groupBy;
+    private getTimeframe;
+    private severityScore;
+    private generateRecommendations;
+}
+export {};
+//# sourceMappingURL=performance-tracker.d.ts.map

package/dist/monitoring/performance-tracker.d.ts.map

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