crewly 1.0.0

package/dist/backend/backend/src/services/event-bus/event-bus.service.js

@@ -0,0 +1,337 @@
+/**
+ * Event Bus Service
+ *
+ * Central pub/sub service for agent lifecycle events. Agents publish events
+ * (idle, busy, active, inactive) and subscribers receive notifications when
+ * matching events occur. Notifications are delivered via the MessageQueueService
+ * to the orchestrator terminal.
+ *
+ * @module services/event-bus/event-bus
+ */
+import { EventEmitter } from 'events';
+import { LoggerService } from '../core/logger.service.js';
+import { EVENT_BUS_CONSTANTS } from '../../constants.js';
+import { isValidCreateSubscriptionInput } from '../../types/event-bus.types.js';
+/**
+ * EventBusService manages event subscriptions and publishes agent lifecycle
+ * events. When an event matches a subscription, a notification message is
+ * enqueued into the MessageQueueService for delivery to the subscriber.
+ *
+ * @example
+ * ```typescript
+ * const eventBus = new EventBusService();
+ * eventBus.setMessageQueueService(queueService);
+ *
+ * eventBus.subscribe({
+ *   eventType: 'agent:idle',
+ *   filter: { sessionName: 'agent-joe' },
+ *   subscriberSession: 'crewly-orc',
+ *   oneShot: true,
+ * });
+ *
+ * eventBus.publish(agentIdleEvent);
+ * ```
+ */
+export class EventBusService extends EventEmitter {
+    logger;
+    subscriptions = new Map();
+    messageQueueService = null;
+    slackThreadStore = null;
+    cleanupInterval = null;
+    deliveryCount = 0;
+    constructor() {
+        super();
+        this.logger = LoggerService.getInstance().createComponentLogger('EventBus');
+        this.startCleanup();
+    }
+    /**
+     * Set the MessageQueueService instance for delivering notifications.
+     *
+     * @param service - The MessageQueueService instance
+     */
+    setMessageQueueService(service) {
+        this.messageQueueService = service;
+    }
+    /**
+     * Set the SlackThreadStoreService for enriching notifications with thread paths.
+     *
+     * @param store - The SlackThreadStoreService instance
+     */
+    setSlackThreadStore(store) {
+        this.slackThreadStore = store;
+    }
+    /**
+     * Create a new event subscription.
+     *
+     * @param input - Subscription configuration
+     * @returns The created EventSubscription
+     * @throws Error if input is invalid or limits are exceeded
+     */
+    subscribe(input) {
+        if (!isValidCreateSubscriptionInput(input)) {
+            throw new Error('Invalid subscription input');
+        }
+        // Check per-session limit
+        const sessionCount = this.getSubscriptionCountForSession(input.subscriberSession);
+        if (sessionCount >= EVENT_BUS_CONSTANTS.MAX_SUBSCRIPTIONS_PER_SESSION) {
+            throw new Error(`Subscription limit reached for session ${input.subscriberSession} (max ${EVENT_BUS_CONSTANTS.MAX_SUBSCRIPTIONS_PER_SESSION})`);
+        }
+        // Check total limit
+        if (this.subscriptions.size >= EVENT_BUS_CONSTANTS.MAX_TOTAL_SUBSCRIPTIONS) {
+            throw new Error(`Total subscription limit reached (max ${EVENT_BUS_CONSTANTS.MAX_TOTAL_SUBSCRIPTIONS})`);
+        }
+        const ttlMinutes = Math.min(input.ttlMinutes ?? EVENT_BUS_CONSTANTS.DEFAULT_SUBSCRIPTION_TTL_MINUTES, EVENT_BUS_CONSTANTS.MAX_SUBSCRIPTION_TTL_MINUTES);
+        const now = new Date();
+        const expiresAt = new Date(now.getTime() + ttlMinutes * 60 * 1000);
+        const subscription = {
+            id: crypto.randomUUID(),
+            eventType: input.eventType,
+            filter: input.filter,
+            oneShot: input.oneShot ?? true,
+            subscriberSession: input.subscriberSession,
+            createdAt: now.toISOString(),
+            expiresAt: expiresAt.toISOString(),
+            messageTemplate: input.messageTemplate,
+        };
+        this.subscriptions.set(subscription.id, subscription);
+        this.logger.info('Subscription created', {
+            subscriptionId: subscription.id,
+            eventType: subscription.eventType,
+            subscriber: subscription.subscriberSession,
+            oneShot: subscription.oneShot,
+            ttlMinutes,
+        });
+        return subscription;
+    }
+    /**
+     * Remove a subscription by ID.
+     *
+     * @param subscriptionId - ID of the subscription to remove
+     * @returns True if the subscription was found and removed
+     */
+    unsubscribe(subscriptionId) {
+        const removed = this.subscriptions.delete(subscriptionId);
+        if (removed) {
+            this.logger.info('Subscription removed', { subscriptionId });
+        }
+        return removed;
+    }
+    /**
+     * Publish an event to all matching subscriptions.
+     * For each match, formats a notification message and enqueues it
+     * into the MessageQueueService for delivery to the subscriber.
+     *
+     * @param event - The agent lifecycle event to publish
+     */
+    publish(event) {
+        this.logger.info('Event published', {
+            eventId: event.id,
+            type: event.type,
+            sessionName: event.sessionName,
+            changedField: event.changedField,
+            previousValue: event.previousValue,
+            newValue: event.newValue,
+        });
+        const toRemove = [];
+        const now = new Date();
+        for (const [id, sub] of this.subscriptions) {
+            // Check expiration
+            if (sub.expiresAt && new Date(sub.expiresAt) < now) {
+                toRemove.push(id);
+                continue;
+            }
+            if (!this.matchesSubscription(event, sub)) {
+                continue;
+            }
+            // Format and deliver notification
+            const message = this.formatNotification(event, sub);
+            this.deliverNotification(sub, message);
+            this.deliveryCount++;
+            this.emit('event_delivered', {
+                subscriptionId: sub.id,
+                eventId: event.id,
+                eventType: event.type,
+            });
+            if (sub.oneShot) {
+                toRemove.push(id);
+            }
+        }
+        // Clean up one-shot and expired subscriptions
+        for (const id of toRemove) {
+            this.subscriptions.delete(id);
+        }
+    }
+    /**
+     * List subscriptions, optionally filtered by subscriber session.
+     *
+     * @param subscriberSession - Optional session name to filter by
+     * @returns Array of matching subscriptions
+     */
+    listSubscriptions(subscriberSession) {
+        const all = Array.from(this.subscriptions.values());
+        if (subscriberSession) {
+            return all.filter((sub) => sub.subscriberSession === subscriberSession);
+        }
+        return all;
+    }
+    /**
+     * Get a specific subscription by ID.
+     *
+     * @param subscriptionId - ID of the subscription
+     * @returns The subscription or undefined
+     */
+    getSubscription(subscriptionId) {
+        return this.subscriptions.get(subscriptionId);
+    }
+    /**
+     * Get event bus statistics.
+     *
+     * @returns Stats object with subscription and delivery counts
+     */
+    getStats() {
+        return {
+            subscriptionCount: this.subscriptions.size,
+            deliveryCount: this.deliveryCount,
+        };
+    }
+    /**
+     * Stop the cleanup timer and clear all subscriptions.
+     */
+    cleanup() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        this.subscriptions.clear();
+        this.logger.info('EventBusService cleaned up');
+    }
+    /**
+     * Check if an event matches a subscription's type and filter criteria.
+     *
+     * @param event - The event to check
+     * @param sub - The subscription to match against
+     * @returns True if the event matches the subscription
+     */
+    matchesSubscription(event, sub) {
+        // Match event type
+        const types = Array.isArray(sub.eventType) ? sub.eventType : [sub.eventType];
+        if (!types.includes(event.type)) {
+            return false;
+        }
+        // Match filter criteria
+        const { filter } = sub;
+        if (filter.sessionName && filter.sessionName !== event.sessionName) {
+            return false;
+        }
+        if (filter.memberId && filter.memberId !== event.memberId) {
+            return false;
+        }
+        if (filter.teamId && filter.teamId !== event.teamId) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Format a notification message for an event and subscription.
+     *
+     * @param event - The event that triggered the notification
+     * @param sub - The subscription that matched
+     * @returns Formatted notification message string
+     */
+    formatNotification(event, sub) {
+        if (sub.messageTemplate) {
+            return sub.messageTemplate
+                .replace(/\{memberName\}/g, event.memberName)
+                .replace(/\{sessionName\}/g, event.sessionName)
+                .replace(/\{eventType\}/g, event.type)
+                .replace(/\{previousValue\}/g, event.previousValue)
+                .replace(/\{newValue\}/g, event.newValue)
+                .replace(/\{teamName\}/g, event.teamName)
+                .replace(/\{teamId\}/g, event.teamId)
+                .replace(/\{memberId\}/g, event.memberId);
+        }
+        const prefix = `[${EVENT_BUS_CONSTANTS.EVENT_MESSAGE_PREFIX}:${sub.id}:${event.type}]`;
+        let baseMessage = `${prefix} Agent "${event.memberName}" (session: ${event.sessionName}) is now ${event.newValue} (was: ${event.previousValue}). Team: ${event.teamName}.`;
+        // Enrich with Slack thread file paths so orchestrator can route notifications
+        if (this.slackThreadStore) {
+            const threads = this.slackThreadStore.findThreadsForAgent(event.sessionName);
+            if (threads.length > 0) {
+                baseMessage += ` [Slack thread files: ${threads.map((t) => t.filePath).join(', ')}]`;
+            }
+        }
+        return baseMessage;
+    }
+    /**
+     * Deliver a notification message to the subscriber via the message queue.
+     *
+     * @param sub - The subscription whose subscriber should receive the message
+     * @param message - The formatted notification message
+     */
+    deliverNotification(sub, message) {
+        if (!this.messageQueueService) {
+            this.logger.warn('MessageQueueService not set, cannot deliver event notification', {
+                subscriptionId: sub.id,
+            });
+            return;
+        }
+        try {
+            this.messageQueueService.enqueue({
+                content: message,
+                conversationId: 'system',
+                source: 'system_event',
+            });
+            this.logger.debug('Event notification enqueued', {
+                subscriptionId: sub.id,
+                subscriber: sub.subscriberSession,
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to enqueue event notification', {
+                subscriptionId: sub.id,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    /**
+     * Get the number of subscriptions for a given subscriber session.
+     *
+     * @param subscriberSession - Session name to count
+     * @returns Number of subscriptions
+     */
+    getSubscriptionCountForSession(subscriberSession) {
+        let count = 0;
+        for (const sub of this.subscriptions.values()) {
+            if (sub.subscriberSession === subscriberSession) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Start the periodic cleanup timer to remove expired subscriptions.
+     */
+    startCleanup() {
+        this.cleanupInterval = setInterval(() => {
+            this.cleanupExpired();
+        }, EVENT_BUS_CONSTANTS.CLEANUP_INTERVAL);
+        // Don't prevent graceful shutdown
+        this.cleanupInterval.unref();
+    }
+    /**
+     * Remove all expired subscriptions.
+     */
+    cleanupExpired() {
+        const now = new Date();
+        let removed = 0;
+        for (const [id, sub] of this.subscriptions) {
+            if (sub.expiresAt && new Date(sub.expiresAt) < now) {
+                this.subscriptions.delete(id);
+                removed++;
+            }
+        }
+        if (removed > 0) {
+            this.logger.debug('Cleaned up expired subscriptions', { removed });
+        }
+    }
+}
+//# sourceMappingURL=event-bus.service.js.map

package/dist/backend/backend/src/services/event-bus/event-bus.service.js.map

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

package/dist/backend/backend/src/services/event-bus/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Event Bus Services Barrel Export
+ *
+ * @module services/event-bus
+ */
+export { EventBusService } from './event-bus.service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/backend/src/services/event-bus/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/event-bus/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/backend/backend/src/services/event-bus/index.js

@@ -0,0 +1,7 @@
+/**
+ * Event Bus Services Barrel Export
+ *
+ * @module services/event-bus
+ */
+export { EventBusService } from './event-bus.service.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/backend/src/services/event-bus/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../backend/src/services/event-bus/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/backend/backend/src/services/factory/factory-sse.service.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Factory SSE Service
+ *
+ * Manages Server-Sent Events connections for real-time factory state updates.
+ * Broadcasts combined data from Crewly teams AND Claude Code processes.
+ *
+ * Instead of each client polling, this service:
+ * - Maintains a single internal poll loop (3s interval)
+ * - Broadcasts updates only when data changes (hash-based diff)
+ * - Sends heartbeats every 30s to keep connections alive
+ *
+ * @module services/factory/factory-sse
+ */
+import { Response } from 'express';
+import { FactoryService, FactoryStateResponse } from '../factory.service.js';
+/**
+ * SSE event types sent to clients
+ */
+export type SSEEventType = 'connected' | 'instances' | 'heartbeat' | 'error';
+/**
+ * SSE event payload structure
+ */
+export interface SSEEvent<T = unknown> {
+    /** Event type */
+    type: SSEEventType;
+    /** Event payload */
+    data: T;
+    /** Timestamp of the event */
+    timestamp: string;
+}
+/**
+ * Factory SSE Service configuration
+ */
+export interface FactorySSEConfig {
+    /** Polling interval in milliseconds (default: 3000) */
+    pollInterval?: number;
+    /** Heartbeat interval in milliseconds (default: 30000) */
+    heartbeatInterval?: number;
+}
+/**
+ * Factory SSE Service for managing real-time client connections
+ */
+export declare class FactorySSEService {
+    /** Connected SSE clients */
+    private clients;
+    /** Factory service for fetching combined factory state */
+    private factoryService;
+    /** Current data hash for change detection */
+    private lastDataHash;
+    /** Last cached response data */
+    private lastData;
+    /** Poll interval timer */
+    private pollTimer;
+    /** Heartbeat interval timer */
+    private heartbeatTimer;
+    /** Polling interval in milliseconds */
+    private pollInterval;
+    /** Heartbeat interval in milliseconds */
+    private heartbeatInterval;
+    /** Whether the service is currently polling */
+    private isPolling;
+    /**
+     * Creates a new FactorySSEService instance
+     *
+     * @param factoryService - Factory service for data fetching (injectable for testing)
+     * @param config - Optional configuration overrides
+     */
+    constructor(factoryService?: FactoryService, config?: FactorySSEConfig);
+    /**
+     * Adds a new SSE client connection
+     *
+     * @param clientId - Unique identifier for the client
+     * @param res - Express Response object configured for SSE
+     */
+    addClient(clientId: string, res: Response): void;
+    /**
+     * Removes a client connection
+     *
+     * @param clientId - Client identifier to remove
+     */
+    removeClient(clientId: string): void;
+    /**
+     * Gets the current number of connected clients
+     *
+     * @returns Number of connected clients
+     */
+    getClientCount(): number;
+    /**
+     * Checks if a specific client is connected
+     *
+     * @param clientId - Client identifier to check
+     * @returns True if client is connected
+     */
+    hasClient(clientId: string): boolean;
+    /**
+     * Starts the internal polling loop
+     */
+    private startPolling;
+    /**
+     * Stops the internal polling loop
+     */
+    private stopPolling;
+    /**
+     * Performs a single poll and broadcasts if data changed
+     */
+    private poll;
+    /**
+     * Computes a hash of the data for change detection
+     * Only includes significant fields to avoid false positives
+     *
+     * @param data - Factory state response (teams + Claude instances)
+     * @returns Hash string for comparison
+     */
+    private computeDataHash;
+    /**
+     * Broadcasts factory state data to all connected clients
+     *
+     * @param data - Factory state response (teams + Claude instances)
+     */
+    private broadcastInstances;
+    /**
+     * Broadcasts a heartbeat to all connected clients
+     */
+    private broadcastHeartbeat;
+    /**
+     * Broadcasts an error to all connected clients
+     *
+     * @param message - Error message
+     * @param code - Error code
+     */
+    private broadcastError;
+    /**
+     * Sends an SSE event to a specific client
+     *
+     * @param client - Client to send to
+     * @param type - Event type
+     * @param data - Event data payload
+     */
+    private sendEvent;
+    /**
+     * Force triggers a poll and broadcast (for testing)
+     */
+    forcePoll(): Promise<void>;
+    /**
+     * Cleans up all resources (for graceful shutdown)
+     */
+    shutdown(): void;
+    /**
+     * Returns whether the service is currently polling
+     *
+     * @returns True if polling is active
+     */
+    isActive(): boolean;
+    /**
+     * Gets the last cached data (for fallback/debugging)
+     *
+     * @returns Last cached factory state response or null
+     */
+    getLastData(): FactoryStateResponse | null;
+}
+/** Singleton instance for use across the application */
+export declare const factorySSEService: FactorySSEService;
+//# sourceMappingURL=factory-sse.service.d.ts.map

package/dist/backend/backend/src/services/factory/factory-sse.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-sse.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/factory/factory-sse.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAG7E;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;AAc7E;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACpC,iBAAiB;IACjB,IAAI,EAAE,YAAY,CAAC;IACnB,oBAAoB;IACpB,IAAI,EAAE,CAAC,CAAC;IACR,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAQD;;GAEG;AACH,qBAAa,iBAAiB;IAC7B,4BAA4B;IAC5B,OAAO,CAAC,OAAO,CAAqC;IAEpD,0DAA0D;IAC1D,OAAO,CAAC,cAAc,CAAiB;IAEvC,6CAA6C;IAC7C,OAAO,CAAC,YAAY,CAAc;IAElC,gCAAgC;IAChC,OAAO,CAAC,QAAQ,CAAqC;IAErD,0BAA0B;IAC1B,OAAO,CAAC,SAAS,CAA+B;IAEhD,+BAA+B;IAC/B,OAAO,CAAC,cAAc,CAA+B;IAErD,uCAAuC;IACvC,OAAO,CAAC,YAAY,CAAS;IAE7B,yCAAyC;IACzC,OAAO,CAAC,iBAAiB,CAAS;IAElC,+CAA+C;IAC/C,OAAO,CAAC,SAAS,CAAkB;IAEnC;;;;;OAKG;gBACS,cAAc,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,gBAAgB;IAMtE;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI;IA4BhD;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IASpC;;;;OAIG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpC;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;YACW,IAAI;IAiBlB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAUvB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAMtB;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAiBjB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;OAEG;IACH,QAAQ,IAAI,IAAI;IAiBhB;;;;OAIG;IACH,QAAQ,IAAI,OAAO;IAInB;;;;OAIG;IACH,WAAW,IAAI,oBAAoB,GAAG,IAAI;CAG1C;AAED,wDAAwD;AACxD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}