stringray-ai 1.0.38 → 1.0.39

package/dist/plugin/delegation/session-coordinator.js

@@ -0,0 +1,346 @@
+/**
+ * StringRay Framework v1.0.0 - Session Coordinator
+ *
+ * Manages cross-agent communication and coordination within sessions.
+ * Tracks delegation state, agent interactions, and conflict resolution.
+ *
+ * @version 1.0.0
+ * @since 2026-01-07
+ */
+export class SessionCoordinator {
+    stateManager;
+    sessions = new Map();
+    constructor(stateManager) {
+        this.stateManager = stateManager;
+    }
+    /**
+     * Initialize session coordination for a new session
+     */
+    initializeSession(sessionId) {
+        if (!sessionId ||
+            typeof sessionId !== "string" ||
+            sessionId.trim() === "") {
+            throw new Error("Invalid session ID: must be a non-empty string");
+        }
+        const context = {
+            sessionId,
+            startTime: Date.now(),
+            activeDelegations: new Map(),
+            agentInteractions: new Map(),
+            conflictHistory: [],
+            coordinationState: {
+                activeAgents: new Set(),
+                pendingCommunications: [],
+                sharedContext: new Map(),
+                sessionMetrics: {
+                    totalInteractions: 0,
+                    successfulInteractions: 0,
+                    failedInteractions: 0,
+                    averageResponseTime: 0,
+                    conflictResolutionRate: 0,
+                    coordinationEfficiency: 0,
+                },
+            },
+            isActive: true,
+        };
+        // Initialize with default agents
+        const defaultAgents = [
+            "enforcer",
+            "architect",
+            "orchestrator",
+            "bug-triage-specialist",
+            "code-reviewer",
+            "security-auditor",
+            "refactorer",
+            "test-architect",
+        ];
+        defaultAgents.forEach((agentName) => {
+            context.coordinationState.activeAgents.add(agentName);
+        });
+        this.sessions.set(sessionId, context);
+        this.stateManager.set(`session:${sessionId}:coordinator`, context);
+        console.log(`📋 Session Coordinator: Initialized session ${sessionId} with ${defaultAgents.length} agents`);
+        return {
+            sessionId,
+            createdAt: new Date(context.startTime),
+            active: context.isActive,
+            agentCount: context.coordinationState.activeAgents.size,
+        };
+    }
+    /**
+     * Register delegation execution in session
+     */
+    registerDelegation(sessionId, delegationId, delegation) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        session.activeDelegations.set(delegationId, delegation);
+        delegation.agents.forEach((agentName) => {
+            session.coordinationState.activeAgents.add(agentName);
+        });
+        this.stateManager.set(`session:${sessionId}:delegations:${delegationId}`, delegation);
+        console.log(`📋 Session Coordinator: Registered delegation ${delegationId} in session ${sessionId}`);
+    }
+    /**
+     * Record agent interaction within session
+     */
+    recordInteraction(sessionId, agentName, interaction) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return;
+        }
+        const fullInteraction = {
+            ...interaction,
+            timestamp: Date.now(),
+        };
+        if (!session.agentInteractions.has(agentName)) {
+            session.agentInteractions.set(agentName, []);
+        }
+        session.agentInteractions.get(agentName).push(fullInteraction);
+        this.updateSessionMetrics(session, fullInteraction);
+        this.stateManager.set(`session:${sessionId}:interactions:${agentName}`, session.agentInteractions.get(agentName));
+    }
+    /**
+     * Send message between agents within session
+     */
+    async sendMessage(sessionId, fromAgent, toAgent, message, priority = "medium") {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        const crypto = require("crypto");
+        const communication = {
+            id: `comm_${Date.now()}_${crypto.randomBytes(4).toString("hex")}`,
+            fromAgent,
+            toAgent,
+            message,
+            timestamp: Date.now(),
+            priority,
+        };
+        session.coordinationState.pendingCommunications.push(communication);
+        this.recordInteraction(sessionId, fromAgent, {
+            agentName: fromAgent,
+            action: "send_message",
+            result: { to: toAgent, message },
+            duration: 0,
+            success: true,
+        });
+        console.log(`💬 Session Coordinator: Message from ${fromAgent} to ${toAgent} in session ${sessionId}`);
+    }
+    /**
+     * Receive pending messages for an agent
+     */
+    receiveMessages(sessionId, agentName) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return [];
+        }
+        const messages = session.coordinationState.pendingCommunications.filter((comm) => comm.toAgent === agentName);
+        session.coordinationState.pendingCommunications =
+            session.coordinationState.pendingCommunications.filter((comm) => comm.toAgent !== agentName);
+        if (messages.length > 0) {
+            this.recordInteraction(sessionId, agentName, {
+                agentName,
+                action: "receive_messages",
+                result: { count: messages.length },
+                duration: 0,
+                success: true,
+            });
+        }
+        return messages;
+    }
+    /**
+     * Share context data between agents
+     */
+    shareContext(sessionId, key, value, fromAgent) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        const existing = session.coordinationState.sharedContext.get(key);
+        const newEntry = {
+            value,
+            fromAgent,
+            timestamp: Date.now(),
+        };
+        if (Array.isArray(existing)) {
+            existing.push(newEntry);
+        }
+        else {
+            session.coordinationState.sharedContext.set(key, [newEntry]);
+        }
+        this.stateManager.set(`session:${sessionId}:shared:${key}`, value);
+        try {
+            this.recordInteraction(sessionId, fromAgent, {
+                agentName: fromAgent,
+                action: "share_context",
+                result: { key, value },
+                duration: 0,
+                success: true,
+            });
+        }
+        catch (error) {
+            console.warn(`⚠️ Failed to record context sharing interaction:`, error);
+            // Continue operation despite recording failure
+        }
+        console.log(`🔗 Session Coordinator: ${fromAgent} shared context '${key}' in session ${sessionId}`);
+    }
+    /**
+     * Get shared context data
+     */
+    getSharedContext(sessionId, key) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return undefined;
+        }
+        const contextData = session.coordinationState.sharedContext.get(key);
+        if (Array.isArray(contextData) && contextData.length > 0) {
+            const last = contextData[contextData.length - 1];
+            return { ...last.value, sharedBy: last.fromAgent };
+        }
+        return undefined;
+    }
+    /**
+     * Record conflict and resolution
+     */
+    recordConflict(sessionId, agents, resolution, outcome) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return;
+        }
+        const crypto = require("crypto");
+        const conflict = {
+            conflictId: `conflict_${Date.now()}_${crypto.randomBytes(4).toString("hex")}`,
+            timestamp: Date.now(),
+            agents,
+            resolution,
+            outcome,
+        };
+        session.conflictHistory.push(conflict);
+        const totalConflicts = session.conflictHistory.length;
+        const successfulResolutions = session.conflictHistory.filter((c) => c.outcome !== undefined).length;
+        session.coordinationState.sessionMetrics.conflictResolutionRate =
+            successfulResolutions / totalConflicts;
+        this.stateManager.set(`session:${sessionId}:conflicts`, session.conflictHistory);
+        console.log(`⚖️ Session Coordinator: Conflict resolved via ${resolution} in session ${sessionId}`);
+    }
+    /**
+     * Complete delegation and cleanup
+     */
+    completeDelegation(sessionId, delegationId, result) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return;
+        }
+        const delegation = session.activeDelegations.get(delegationId);
+        if (delegation) {
+            session.activeDelegations.delete(delegationId);
+            this.stateManager.set(`session:${sessionId}:completed:${delegationId}`, {
+                delegation,
+                result,
+                completedAt: Date.now(),
+            });
+            console.log(`✅ Session Coordinator: Completed delegation ${delegationId} in session ${sessionId}`);
+        }
+    }
+    /**
+     * Get session coordination status
+     */
+    getSessionStatus(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return null;
+        }
+        return {
+            active: session.isActive,
+            agentCount: session.coordinationState.activeAgents.size,
+        };
+    }
+    /**
+     * Resolve conflicts using specified strategy
+     */
+    resolveConflict(sessionId, conflictKey, strategy) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        const sharedData = session.coordinationState.sharedContext.get(conflictKey);
+        if (!sharedData || !Array.isArray(sharedData)) {
+            return undefined;
+        }
+        let resolved;
+        switch (strategy) {
+            case "majority_vote":
+                // Find most common value
+                const counts = {};
+                sharedData.forEach((item) => {
+                    const value = JSON.stringify(item.value);
+                    counts[value] = (counts[value] || 0) + 1;
+                });
+                const majorityEntry = Object.entries(counts).reduce(([keyA, countA], [keyB, countB]) => (countA > countB ? [keyA, countA] : [keyB, countB]));
+                if (majorityEntry) {
+                    resolved = JSON.parse(majorityEntry[0]);
+                }
+                break;
+            case "expert_priority":
+                // Use security-auditor if available, otherwise first value
+                const expertItem = sharedData.find((item) => item.fromAgent === "security-auditor");
+                resolved = expertItem ? expertItem.value : sharedData[0]?.value;
+                break;
+            case "consensus":
+                // All values must be the same
+                const firstValue = sharedData[0]?.value;
+                const allSame = sharedData.every((item) => JSON.stringify(item.value) === JSON.stringify(firstValue));
+                resolved = allSame ? firstValue : undefined;
+                break;
+        }
+        // Record the conflict resolution
+        const agents = sharedData.map((item) => item.fromAgent);
+        this.recordConflict(sessionId, agents, strategy, resolved);
+        return resolved;
+    }
+    /**
+     * Cleanup session coordination data
+     */
+    cleanupSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return;
+        }
+        // Clear all session data
+        session.activeDelegations.clear();
+        session.agentInteractions.clear();
+        session.conflictHistory = [];
+        session.coordinationState.activeAgents.clear();
+        session.coordinationState.pendingCommunications = [];
+        session.coordinationState.sharedContext.clear();
+        // Remove session from active sessions map
+        this.sessions.delete(sessionId);
+        // Clear from state manager
+        this.stateManager.clear(`session:${sessionId}:coordinator`);
+        console.log(`🧹 Session Coordinator: Cleaned up session ${sessionId} (removed)`);
+    }
+    // Private methods
+    updateSessionMetrics(session, interaction) {
+        const metrics = session.coordinationState.sessionMetrics;
+        metrics.totalInteractions++;
+        if (interaction.success) {
+            metrics.successfulInteractions++;
+        }
+        else {
+            metrics.failedInteractions++;
+        }
+        const totalResponseTime = metrics.averageResponseTime * (metrics.totalInteractions - 1) +
+            interaction.duration;
+        metrics.averageResponseTime = totalResponseTime / metrics.totalInteractions;
+        const successRate = metrics.successfulInteractions / metrics.totalInteractions;
+        const conflictRate = session.conflictHistory.length / Math.max(metrics.totalInteractions, 1);
+        metrics.coordinationEfficiency = successRate * (1 - conflictRate);
+    }
+}
+// Export singleton instance factory
+export const createSessionCoordinator = (stateManager) => {
+    return new SessionCoordinator(stateManager);
+};
+//# sourceMappingURL=session-coordinator.js.map

package/dist/plugin/delegation/session-coordinator.js.map

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

package/dist/plugin/index.d.ts

@@ -0,0 +1,3 @@
+export { StringRayOrchestrator } from './orchestrator.js';
+export { defaultStringRayConfig } from './strray-activation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/plugin/index.js

@@ -0,0 +1,3 @@
+export { StringRayOrchestrator } from './orchestrator.js';
+export { defaultStringRayConfig } from './strray-activation.js';
+//# sourceMappingURL=index.js.map

package/dist/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/plugin/monitoring/memory-monitor.d.ts

@@ -0,0 +1,113 @@
+import { EventEmitter } from "events";
+/**
+ * Memory Monitor - Comprehensive memory tracking and leak detection
+ * Integrates with framework logging system
+ */
+export interface MemoryStats {
+    heapUsed: number;
+    heapTotal: number;
+    external: number;
+    rss: number;
+    timestamp: number;
+    sessionId?: string;
+}
+export interface MemoryLeakAlert {
+    type: "leak_detected" | "high_usage" | "spike_detected";
+    severity: "low" | "medium" | "high" | "critical";
+    message: string;
+    details: {
+        currentUsage: number;
+        threshold: number;
+        trend: "increasing" | "stable" | "decreasing";
+        recommendations: string[];
+    };
+}
+export interface MemoryMonitorConfig {
+    checkInterval: number;
+    alertThresholds: {
+        warning: number;
+        critical: number;
+        leakDetection: {
+            growthRate: number;
+            sustainedPeriod: number;
+        };
+    };
+    enableFrameworkLogging: boolean;
+    sessionTracking: boolean;
+}
+export interface MemorySummary {
+    current: MemoryStats;
+    peak: MemoryStats;
+    average: number;
+    trend: "increasing" | "stable" | "decreasing";
+}
+export declare class MemoryMonitor extends EventEmitter {
+    private config;
+    private monitoringInterval;
+    private statsHistory;
+    private maxHistorySize;
+    private leakDetectionEnabled;
+    private lastLeakCheck;
+    private leakCheckInterval;
+    constructor(config?: Partial<MemoryMonitorConfig>);
+    /**
+     * Start memory monitoring
+     */
+    start(): void;
+    /**
+     * Stop memory monitoring
+     */
+    stop(): void;
+    /**
+     * Get current memory statistics
+     */
+    getCurrentStats(): MemoryStats;
+    /**
+     * Check memory usage and detect issues
+     */
+    private checkMemory;
+    /**
+     * Check memory usage against thresholds
+     */
+    private checkThresholds;
+    /**
+     * Detect potential memory leaks
+     */
+    private detectMemoryLeaks;
+    /**
+     * Calculate memory usage trend
+     */
+    private calculateTrend;
+    /**
+     * Emit memory alert
+     */
+    private emitAlert;
+    /**
+     * Log memory stats to framework log
+     */
+    private logFrameworkMemory;
+    /**
+     * Get memory usage history
+     */
+    getHistory(hours?: number): MemoryStats[];
+    /**
+     * Get memory usage summary
+     */
+    getSummary(): MemorySummary;
+    /**
+     * Force garbage collection (if available)
+     */
+    forceGC(): boolean;
+    /**
+     * Internal logging method - writes to framework log only
+     */
+    private log;
+}
+export declare const memoryMonitor: MemoryMonitor;
+export declare function getMemoryUsage(): MemoryStats;
+export declare function logMemoryUsage(): void;
+export declare function checkMemoryHealth(): {
+    healthy: boolean;
+    issues: string[];
+};
+//# sourceMappingURL=memory-monitor.d.ts.map

package/dist/plugin/monitoring/memory-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-monitor.d.ts","sourceRoot":"","sources":["../../../src/monitoring/memory-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,GAAG,YAAY,GAAG,gBAAgB,CAAC;IACxD,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,YAAY,GAAG,QAAQ,GAAG,YAAY,CAAC;QAC9C,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE;YACb,UAAU,EAAE,MAAM,CAAC;YACnB,eAAe,EAAE,MAAM,CAAC;SACzB,CAAC;KACH,CAAC;IACF,sBAAsB,EAAE,OAAO,CAAC;IAChC,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,YAAY,GAAG,QAAQ,GAAG,YAAY,CAAC;CAC/C;AAED,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,kBAAkB,CAA+B;IACzD,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,oBAAoB,CAAQ;IACpC,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,iBAAiB,CAAiB;gBAE9B,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM;IAmBrD;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;IACH,eAAe,IAAI,WAAW;IAW9B;;OAEG;IACH,OAAO,CAAC,WAAW;IAuBnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAuCvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0CzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBtB;;OAEG;IACH,OAAO,CAAC,SAAS;IAiBjB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;OAEG;IACH,UAAU,CAAC,KAAK,GAAE,MAAU,GAAG,WAAW,EAAE;IAK5C;;OAEG;IACH,UAAU,IAAI,aAAa;IAoB3B;;OAEG;IACH,OAAO,IAAI,OAAO;IAelB;;OAEG;IACH,OAAO,CAAC,GAAG;CAiBZ;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC;AAGjD,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAED,wBAAgB,cAAc,IAAI,IAAI,CAKrC;AAED,wBAAgB,iBAAiB,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAgB1E"}