crewly 1.13.0 → 1.14.0

package/dist/cli/backend/src/websocket/chat.gateway.js

@@ -0,0 +1,327 @@
+/**
+ * Chat Gateway Module
+ *
+ * Integrates chat functionality with the WebSocket infrastructure.
+ * Forwards chat events from ChatService to connected clients.
+ *
+ * @module websocket/chat.gateway
+ */
+import { getChatV2Service } from '../services/chat-v2/chat-v2.singleton.js';
+import { SYSTEM_PRINCIPAL, v2MessageToLegacy, v2ChannelToLegacy, senderToV2, } from '../services/chat-v2/legacy-dto.utils.js';
+import { LoggerService } from '../services/core/logger.service.js';
+/**
+ * Chat Gateway class for WebSocket-based chat messaging.
+ *
+ * Provides:
+ * - Real-time chat message broadcasting
+ * - Typing indicator support
+ * - Conversation update notifications
+ * - Terminal output to chat message processing
+ */
+export class ChatGateway {
+    io;
+    logger;
+    chatV2;
+    initialized = false;
+    /**
+     * Create a new ChatGateway.
+     *
+     * @param io - Socket.IO server instance
+     */
+    constructor(io) {
+        this.io = io;
+        this.logger = LoggerService.getInstance().createComponentLogger('ChatGateway');
+        this.chatV2 = getChatV2Service();
+    }
+    /**
+     * Initialize the chat gateway.
+     *
+     * Subscribes to chat-v2 message events and wires the
+     * client-facing WebSocket handlers.
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        this.setupChatV2Listeners();
+        this.setupWebSocketHandlers();
+        this.initialized = true;
+        this.logger.info('ChatGateway initialized');
+    }
+    /**
+     * Subscribe to ChatV2Service events and broadcast to WebSocket clients.
+     * Phase 6c of the unified-chat-message-store spec — replaces the
+     * legacy ChatService EventEmitter wiring.
+     */
+    setupChatV2Listeners() {
+        this.chatV2.on('chat_message', (dto) => {
+            const legacy = v2MessageToLegacy(dto);
+            this.logger.debug('Broadcasting chat_message', { messageId: legacy.id });
+            this.broadcast('chat_message', {
+                type: 'chat_message',
+                data: legacy,
+                timestamp: new Date().toISOString(),
+            });
+        });
+    }
+    /**
+     * Set up WebSocket event handlers for chat-specific events.
+     */
+    setupWebSocketHandlers() {
+        this.io.on('connection', (socket) => {
+            // Handle chat conversation subscription
+            socket.on('subscribe_to_chat', async (conversationId) => {
+                this.logger.debug('Client subscribing to chat', {
+                    socketId: socket.id,
+                    conversationId,
+                });
+                // Join chat room
+                socket.join('chat');
+                if (conversationId) {
+                    socket.join(`chat_${conversationId}`);
+                }
+                // Send current conversation if requested
+                if (conversationId) {
+                    try {
+                        const channel = this.chatV2.getChannel(conversationId, SYSTEM_PRINCIPAL);
+                        const messageCount = this.chatV2.countChannelMessages(conversationId, SYSTEM_PRINCIPAL);
+                        socket.emit('chat_conversation', {
+                            type: 'chat_conversation',
+                            data: v2ChannelToLegacy(channel, messageCount),
+                            timestamp: new Date().toISOString(),
+                        });
+                    }
+                    catch {
+                        // Channel not found / unauthorized — silently skip; the
+                        // client will see no chat_conversation event.
+                    }
+                }
+                socket.emit('chat_subscribed', {
+                    type: 'chat_subscribed',
+                    data: { conversationId },
+                    timestamp: new Date().toISOString(),
+                });
+            });
+            // Handle unsubscription from chat
+            socket.on('unsubscribe_from_chat', (conversationId) => {
+                socket.leave('chat');
+                if (conversationId) {
+                    socket.leave(`chat_${conversationId}`);
+                }
+            });
+            // Handle typing indicator from client
+            socket.on('chat_typing', (data) => {
+                // User typing indicators are just echoed to other clients
+                socket.to(`chat_${data.conversationId}`).emit('chat_typing', {
+                    type: 'chat_typing',
+                    data: {
+                        conversationId: data.conversationId,
+                        sender: { type: 'user' },
+                        isTyping: data.isTyping,
+                    },
+                    timestamp: new Date().toISOString(),
+                });
+            });
+        });
+    }
+    /**
+     * Broadcast a message to all clients in the chat room.
+     *
+     * @param event - Event name
+     * @param message - Message to broadcast
+     */
+    broadcast(event, message) {
+        this.io.to('chat').emit(event, message);
+    }
+    /**
+     * Broadcast a message to a specific conversation room.
+     *
+     * @param conversationId - Conversation ID
+     * @param event - Event name
+     * @param message - Message to broadcast
+     */
+    broadcastToConversation(conversationId, event, message) {
+        this.io.to(`chat_${conversationId}`).emit(event, message);
+    }
+    /**
+     * Process terminal output and convert to chat message if applicable.
+     *
+     * Checks for response markers in terminal output and creates
+     * chat messages from extracted content.
+     *
+     * @param sessionId - The session/agent ID that produced the output
+     * @param output - Raw terminal output
+     * @param conversationId - Target conversation ID
+     * @returns The created chat message, or null if no response marker found
+     */
+    async processTerminalOutput(sessionId, output, conversationId) {
+        // Only process if there's an active conversation
+        if (!conversationId)
+            return null;
+        // Check if output contains response markers
+        const hasResponseMarker = output.includes('[RESPONSE]') ||
+            output.includes('[CHAT_RESPONSE]') ||
+            output.includes('```response');
+        if (!hasResponseMarker)
+            return null;
+        try {
+            const channel = this.chatV2.ensureChannelForLegacyConversation({
+                conversationId,
+                agentSession: 'crewly-orc',
+            });
+            const { message } = this.chatV2.recordTurn({
+                channelId: channel.id,
+                senderType: 'agent',
+                senderId: sessionId,
+                content: output,
+                metadata: { source: 'pty-runtime', sessionId },
+            });
+            const legacyMessage = v2MessageToLegacy(message);
+            this.logger.debug('Added agent message to chat', {
+                messageId: legacyMessage.id,
+                conversationId,
+            });
+            return legacyMessage;
+        }
+        catch (error) {
+            this.logger.error('Failed to process terminal output for chat', {
+                sessionId,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            return null;
+        }
+    }
+    /**
+     * Process a unified [NOTIFY] message and add it directly to a conversation.
+     *
+     * Unlike `processTerminalOutput`, this method takes pre-extracted content
+     * from a [NOTIFY] payload — no regex extraction needed. Optional metadata
+     * (e.g. Slack delivery tracking fields) is merged into the message metadata.
+     *
+     * @param sessionId - The session/agent ID that produced the output
+     * @param content - Pre-extracted markdown content from NotifyPayload.message
+     * @param conversationId - Target conversation ID
+     * @param metadata - Optional additional metadata to attach to the message
+     * @returns The created chat message, or null on failure
+     */
+    async processNotifyMessage(sessionId, content, conversationId, metadata) {
+        try {
+            const channel = this.chatV2.ensureChannelForLegacyConversation({
+                conversationId,
+                agentSession: 'crewly-orc',
+            });
+            const { message } = this.chatV2.recordTurn({
+                channelId: channel.id,
+                senderType: 'agent',
+                senderId: sessionId,
+                content,
+                metadata: {
+                    sessionId,
+                    ...(metadata ?? {}),
+                    // `source` is set LAST so a caller cannot clobber the audit
+                    // discriminator. It is a closed enum (RECORD_TURN_SOURCES) owned by
+                    // this path; when a caller spread an out-of-enum value over it, the
+                    // write failed validation and the agent's reply was dropped after the
+                    // work was already done. Callers may add metadata, not redefine
+                    // where the turn came from.
+                    source: 'in-process-runtime',
+                },
+            });
+            const legacyMessage = v2MessageToLegacy(message);
+            this.logger.debug('Added notify message to chat', {
+                messageId: legacyMessage.id,
+                conversationId,
+            });
+            return legacyMessage;
+        }
+        catch (error) {
+            this.logger.error('Failed to process notify message for chat', {
+                sessionId,
+                conversationId,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            return null;
+        }
+    }
+    /**
+     * Emit a typing indicator for the orchestrator.
+     *
+     * Call this when the orchestrator starts/stops processing a message.
+     *
+     * @param conversationId - Conversation ID
+     * @param isTyping - Whether the orchestrator is typing
+     */
+    emitOrchestratorTyping(conversationId, isTyping) {
+        this.broadcastTyping(conversationId, { type: 'orchestrator', name: 'Orchestrator' }, isTyping);
+    }
+    /**
+     * Emit a typing indicator for an agent.
+     *
+     * @param conversationId - Conversation ID
+     * @param sender - Agent sender information
+     * @param isTyping - Whether the agent is typing
+     */
+    emitAgentTyping(conversationId, sender, isTyping) {
+        this.broadcastTyping(conversationId, sender, isTyping);
+    }
+    /**
+     * Emit a typing indicator via the WebSocket broadcast channel.
+     * Phase 6c: typing indicators were previously emitted on the
+     * legacy ChatService EventEmitter; with that retired, the gateway
+     * sources them directly. Typing is transient and never persisted,
+     * so no chat-v2 write is involved.
+     *
+     * @param conversationId - Conversation ID
+     * @param sender - Sender descriptor
+     * @param isTyping - Whether the sender is typing
+     */
+    broadcastTyping(conversationId, sender, isTyping) {
+        // Resolve sender type via the shared mapper so the wire shape
+        // matches what existing subscribers expect.
+        senderToV2(sender);
+        this.broadcast('chat_typing', {
+            type: 'chat_typing',
+            data: { conversationId, sender, isTyping },
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Check if the gateway is initialized.
+     *
+     * @returns True if initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+}
+// =============================================================================
+// Singleton Instance
+// =============================================================================
+let chatGatewayInstance = null;
+/**
+ * Initialize the ChatGateway with a Socket.IO server.
+ *
+ * @param io - Socket.IO server instance
+ * @returns The ChatGateway instance
+ */
+export async function initializeChatGateway(io) {
+    if (!chatGatewayInstance) {
+        chatGatewayInstance = new ChatGateway(io);
+        await chatGatewayInstance.initialize();
+    }
+    return chatGatewayInstance;
+}
+/**
+ * Get the ChatGateway instance.
+ *
+ * @returns The ChatGateway instance or null if not initialized
+ */
+export function getChatGateway() {
+    return chatGatewayInstance;
+}
+/**
+ * Reset the ChatGateway instance (for testing).
+ */
+export function resetChatGateway() {
+    chatGatewayInstance = null;
+}
+//# sourceMappingURL=chat.gateway.js.map

package/dist/cli/backend/src/websocket/chat.gateway.js.map

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

package/dist/cli/backend/src/websocket/terminal.gateway.d.ts

@@ -0,0 +1,341 @@
+/**
+ * Terminal Gateway Module
+ *
+ * Provides WebSocket-based real-time terminal streaming for PTY and in-process sessions.
+ * Uses event-based streaming instead of polling for better performance.
+ *
+ * In-process sessions (Crewly Agent runtime) are streamed via InProcessLogBuffer
+ * EventEmitter events, while PTY sessions use native onData events.
+ *
+ * @module terminal-gateway
+ */
+import { Server as SocketIOServer, Socket } from 'socket.io';
+/**
+ * Terminal Gateway class for WebSocket-based terminal streaming.
+ *
+ * Provides:
+ * - Real-time terminal output streaming via PTY onData events
+ * - Terminal input forwarding to PTY sessions
+ * - Terminal resize handling
+ * - Session subscription management
+ */
+export declare class TerminalGateway {
+    private io;
+    private logger;
+    /** Map of session name to set of subscribed socket IDs */
+    private connectedClients;
+    /** Map of session name to unsubscribe function for PTY onData */
+    private sessionSubscriptions;
+    /** Set of sessions with persistent monitoring (not stopped on client disconnect) */
+    private persistentMonitoringSessions;
+    /**
+     * Pending retry timers for eager monitoring attempts that fired before the
+     * PTY session was registered in the SessionBackend.
+     *
+     * Keyed by session name. Cleared on first successful attach, on stop, and
+     * on destroy so a backoff schedule never leaks a timer past the gateway.
+     */
+    private pendingMonitoringRetries;
+    /** Current active chat conversation ID for orchestrator responses */
+    private activeConversationId;
+    /**
+     * Sessions in read-only mode for security auditing.
+     * Terminal output is streamed normally, but all input is blocked.
+     * Used for compliance auditing and observing agent behavior safely.
+     */
+    private readOnlySessions;
+    /**
+     * Set of in-process sessions currently being streamed via InProcessLogBuffer.
+     * These sessions are automatically read-only (no PTY to write to).
+     */
+    private inProcessStreamingSessions;
+    /**
+     * Bound handler for InProcessLogBuffer 'data' events.
+     * Stored so it can be removed on destroy.
+     */
+    private inProcessDataHandler;
+    /**
+     * Create a new TerminalGateway.
+     *
+     * @param io - Socket.IO server instance
+     */
+    constructor(io: SocketIOServer);
+    /**
+     * Set up WebSocket event handlers.
+     */
+    private setupEventHandlers;
+    /**
+     * Set up real-time log streaming from InProcessLogBuffer.
+     *
+     * Listens for 'data' events emitted when InProcessLogBuffer.append() is called,
+     * and broadcasts the formatted log line to all WebSocket subscribers of that session.
+     */
+    private setupInProcessLogStreaming;
+    /**
+     * Check if a session is an in-process Crewly Agent session.
+     *
+     * @param sessionName - The session to check
+     * @returns True if the session exists in InProcessLogBuffer
+     */
+    isInProcessSession(sessionName: string): boolean;
+    /**
+     * Subscribe a client to a specific terminal session.
+     *
+     * @param sessionName - The session to subscribe to
+     * @param socket - The client socket
+     */
+    subscribeToSession(sessionName: string, socket: Socket): void;
+    /**
+     * Start streaming logs from an in-process Crewly Agent session.
+     *
+     * In-process sessions are automatically read-only (no PTY to write to).
+     * Real-time streaming is handled by the InProcessLogBuffer 'data' event
+     * listener set up in setupInProcessLogStreaming().
+     *
+     * @param sessionName - The session to stream from
+     * @returns True if the session is an in-process session and streaming started
+     */
+    private startInProcessStreaming;
+    /**
+     * Start streaming output from a PTY session.
+     * Uses event-based onData instead of polling.
+     *
+     * @param sessionName - The session to stream from
+     * @returns True if streaming started successfully, false otherwise
+     */
+    private startPtyStreaming;
+    /**
+     * Stop streaming output from a PTY session.
+     * Does not stop sessions with persistent monitoring enabled.
+     *
+     * @param sessionName - The session to stop streaming from
+     * @param force - Force stop even for persistent monitoring sessions
+     */
+    private stopPtyStreaming;
+    /**
+     * Start persistent monitoring for the orchestrator session.
+     *
+     * Ensures chat responses are captured even when no WebSocket clients are
+     * viewing the terminal. If the PTY session is not yet registered in the
+     * SessionBackend (e.g. eager call from boot fires before
+     * createAgentSession's backend registration completes), schedules bounded
+     * retries on the {@link TERMINAL_GATEWAY_CONSTANTS.MONITORING_RETRY_BACKOFFS_MS}
+     * backoff schedule. Persistent flag stays set across retries so a parallel
+     * subscriber path doesn't bypass eventual attachment.
+     *
+     * @param sessionName - The orchestrator session name to monitor
+     * @returns True if monitoring started synchronously on first attempt; false
+     *          if a retry was scheduled (caller-visible failure is reserved for
+     *          terminal failure after all retries, surfaced via ERROR log only).
+     */
+    startOrchestratorChatMonitoring(sessionName: string): boolean;
+    /**
+     * Schedule the next bounded retry attempt to attach orchestrator monitoring.
+     *
+     * @param sessionName - Session name being monitored
+     * @param attemptIndex - 0-based index into MONITORING_RETRY_BACKOFFS_MS
+     */
+    private scheduleMonitoringRetry;
+    /**
+     * Clear any pending monitoring retry timer for a session.
+     *
+     * Idempotent — safe to call when no retry is queued.
+     *
+     * @param sessionName - Session name whose retry should be cleared
+     */
+    private clearPendingMonitoringRetry;
+    /**
+     * Stop persistent monitoring for the orchestrator session.
+     *
+     * Cancels any in-flight retry schedule so a stop mid-backoff doesn't leak
+     * a timer that later attaches to a session the caller already gave up on.
+     *
+     * @param sessionName - The orchestrator session name
+     */
+    stopOrchestratorChatMonitoring(sessionName: string): void;
+    /**
+     * Clean up session subscription when session ends.
+     *
+     * @param sessionName - The session to clean up
+     */
+    private cleanupSessionSubscription;
+    /**
+     * Unsubscribe a client from a terminal session.
+     *
+     * @param sessionName - The session to unsubscribe from
+     * @param socket - The client socket
+     */
+    unsubscribeFromSession(sessionName: string, socket: Socket): void;
+    /**
+     * Send input to a terminal session.
+     *
+     * @param sessionName - The session to send input to
+     * @param input - The input string
+     * @param socket - The client socket
+     */
+    sendInput(sessionName: string, input: string, socket: Socket): Promise<void>;
+    /**
+     * Handle terminal resize events.
+     *
+     * @param sessionName - The session to resize
+     * @param cols - New column count
+     * @param rows - New row count
+     */
+    private handleTerminalResize;
+    /**
+     * Handle client disconnection.
+     *
+     * @param socket - The disconnected client socket
+     */
+    private handleClientDisconnect;
+    /**
+     * Broadcast terminal output to all subscribers of a session.
+     * Also processes orchestrator output for chat responses.
+     *
+     * @param sessionName - The session name
+     * @param output - The terminal output
+     */
+    private broadcastOutput;
+    /**
+     * Enable read-only mode for a session. Output streaming continues but
+     * all input is blocked. Used for security auditing and safe observation.
+     *
+     * @param sessionName - The session to set as read-only
+     */
+    setReadOnly(sessionName: string): void;
+    /**
+     * Disable read-only mode for a session, restoring normal input capability.
+     *
+     * @param sessionName - The session to restore
+     */
+    clearReadOnly(sessionName: string): void;
+    /**
+     * Check if a session is in read-only (audit) mode.
+     *
+     * @param sessionName - The session to check
+     * @returns True if the session is read-only
+     */
+    isReadOnly(sessionName: string): boolean;
+    /**
+     * Set the active conversation ID for orchestrator chat responses.
+     *
+     * @param conversationId - The conversation ID to set
+     */
+    setActiveConversationId(conversationId: string | null): void;
+    /**
+     * Get the active conversation ID.
+     *
+     * @returns The active conversation ID or null
+     */
+    getActiveConversationId(): string | null;
+    /**
+     * Broadcast session status changes.
+     *
+     * @param sessionName - The session name
+     * @param status - The status string
+     */
+    private broadcastSessionStatus;
+    /**
+     * Broadcast general messages to session subscribers.
+     *
+     * @param sessionName - The session name
+     * @param type - Message type
+     * @param payload - Message payload
+     */
+    private broadcastMessage;
+    /**
+     * Send current terminal state to a new subscriber.
+     *
+     * @param sessionName - The session name
+     * @param socket - The client socket
+     */
+    private sendCurrentTerminalState;
+    /**
+     * Get statistics about connected clients.
+     *
+     * @returns Connection statistics
+     */
+    getConnectionStats(): {
+        totalClients: number;
+        sessionSubscriptions: Record<string, number>;
+        totalSessions: number;
+        activeStreams: number;
+    };
+    /**
+     * Force disconnect all clients from a session.
+     *
+     * @param sessionName - The session name
+     */
+    disconnectSessionClients(sessionName: string): void;
+    /**
+     * Broadcast system-wide notifications.
+     *
+     * @param message - Notification message
+     * @param type - Notification type
+     */
+    broadcastSystemNotification(message: string, type?: 'info' | 'warning' | 'error'): void;
+    /**
+     * Broadcast orchestrator status changes.
+     *
+     * @param orchestratorData - Orchestrator data
+     */
+    broadcastOrchestratorStatus(orchestratorData: unknown): void;
+    /**
+     * Broadcast team member status changes.
+     *
+     * @param memberData - Team member data
+     */
+    broadcastTeamMemberStatus(memberData: unknown): void;
+    /**
+     * Broadcast a system resource alert to all connected clients.
+     *
+     * @param alertData - Alert details including key, message, severity, and timestamp
+     */
+    broadcastSystemResourceAlert(alertData: {
+        alertKey: string;
+        message: string;
+        severity: string;
+        timestamp: string;
+    }): void;
+    /**
+     * Broadcast context window status updates to all connected clients.
+     *
+     * @param contextData - Context window status data
+     */
+    broadcastContextWindowStatus(contextData: {
+        sessionName: string;
+        memberId?: string;
+        teamId?: string;
+        contextPercent: number;
+        level: string;
+        timestamp: string;
+    }): void;
+    /**
+     * Broadcast comprehensive team activity updates.
+     *
+     * @param activityData - Activity data
+     */
+    broadcastTeamActivity(activityData: unknown): void;
+    /**
+     * Destroy the gateway and clean up all subscriptions.
+     */
+    destroy(): void;
+}
+/**
+ * Set the terminal gateway singleton instance.
+ * Called during server initialization.
+ *
+ * @param gateway - The TerminalGateway instance
+ */
+export declare function setTerminalGateway(gateway: TerminalGateway): void;
+/**
+ * Get the terminal gateway singleton instance.
+ *
+ * @returns The TerminalGateway instance or null if not initialized
+ */
+export declare function getTerminalGateway(): TerminalGateway | null;
+/**
+ * Reset the terminal gateway singleton instance (for testing).
+ */
+export declare function resetTerminalGateway(): void;
+//# sourceMappingURL=terminal.gateway.d.ts.map

package/dist/cli/backend/src/websocket/terminal.gateway.d.ts.map

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