crewly 1.0.0

package/dist/backend/backend/src/services/chat/chat.service.d.ts

@@ -0,0 +1,358 @@
+/**
+ * Chat Service
+ *
+ * Manages chat conversations and messages for the conversational dashboard.
+ * Handles message persistence, conversation management, and real-time updates
+ * via event emission.
+ *
+ * @module services/chat/chat.service
+ */
+import { EventEmitter } from 'events';
+import { ChatMessage, ChatConversation, ChatSender, SendMessageInput, SendMessageResult, ChatMessageFilter, ConversationFilter } from '../../types/chat.types.js';
+/**
+ * Error thrown when a conversation is not found
+ */
+export declare class ConversationNotFoundError extends Error {
+    readonly conversationId: string;
+    constructor(conversationId: string);
+}
+/**
+ * Error thrown when message validation fails
+ */
+export declare class MessageValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Configuration options for the ChatService
+ */
+export interface ChatServiceOptions {
+    /** Directory to store chat data (default: ~/.crewly/chat) */
+    chatDir?: string;
+}
+/**
+ * Service for managing chat conversations and messages
+ *
+ * Handles:
+ * - Message persistence to ~/.crewly/chat/
+ * - Conversation management
+ * - Message formatting (raw terminal → clean chat)
+ * - WebSocket event emission for real-time updates
+ *
+ * @example
+ * ```typescript
+ * const chatService = getChatService();
+ * await chatService.initialize();
+ *
+ * // Send a message
+ * const result = await chatService.sendMessage({
+ *   content: 'Hello, Orchestrator!',
+ * });
+ *
+ * // Get messages
+ * const messages = await chatService.getMessages({
+ *   conversationId: result.conversation.id,
+ * });
+ * ```
+ */
+export declare class ChatService extends EventEmitter {
+    private readonly chatDir;
+    private readonly logger;
+    private conversations;
+    private messages;
+    private initialized;
+    /** Per-conversation save serialization to prevent concurrent write corruption */
+    private savePromises;
+    /**
+     * Create a new ChatService instance
+     *
+     * @param options - Configuration options
+     */
+    constructor(options?: ChatServiceOptions);
+    /**
+     * Initialize the chat service
+     *
+     * Creates the chat directory if it doesn't exist and loads
+     * existing conversations from disk.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if the service is initialized
+     *
+     * @returns True if initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Ensure the service is initialized before performing operations
+     *
+     * @throws Error if not initialized and auto-initialize fails
+     */
+    private ensureInitialized;
+    /**
+     * Send a message (from user to orchestrator)
+     *
+     * @param input - Message input
+     * @returns The sent message and conversation
+     * @throws MessageValidationError if input is invalid
+     *
+     * @example
+     * ```typescript
+     * const result = await chatService.sendMessage({
+     *   content: 'Start the project analysis',
+     * });
+     * console.log(result.message.id);
+     * ```
+     */
+    sendMessage(input: SendMessageInput): Promise<SendMessageResult>;
+    /**
+     * Add a message from an agent or orchestrator
+     *
+     * Typically called when processing terminal output. Extracts and
+     * formats the response content.
+     *
+     * @param conversationId - Conversation to add the message to
+     * @param rawOutput - Raw terminal output
+     * @param sender - Sender information
+     * @param metadata - Optional metadata
+     * @returns The created message
+     *
+     * @example
+     * ```typescript
+     * const message = await chatService.addAgentMessage(
+     *   'conv-123',
+     *   '[RESPONSE]Task completed successfully[/RESPONSE]',
+     *   { type: 'orchestrator', name: 'Orchestrator' }
+     * );
+     * ```
+     */
+    addAgentMessage(conversationId: string, rawOutput: string, sender: ChatSender, metadata?: Record<string, unknown>): Promise<ChatMessage>;
+    /**
+     * Add a message with pre-extracted content (no regex extraction).
+     *
+     * Unlike `addAgentMessage`, this method skips `extractResponseFromOutput()`
+     * and takes already-cleaned content directly. Used by the unified [NOTIFY]
+     * marker handler where content is extracted from JSON payload.
+     *
+     * Emits the `'message'` event that QueueProcessor's `waitForResponse()` depends on.
+     *
+     * @param conversationId - Conversation to add the message to
+     * @param content - Pre-extracted markdown content
+     * @param sender - Sender information
+     * @param metadata - Optional metadata
+     * @returns The created message
+     *
+     * @example
+     * ```typescript
+     * const message = await chatService.addDirectMessage(
+     *   'conv-123',
+     *   '## Status Update\n\nEmily is working...',
+     *   { type: 'orchestrator', name: 'Orchestrator' }
+     * );
+     * ```
+     */
+    addDirectMessage(conversationId: string, content: string, sender: ChatSender, metadata?: Record<string, unknown>): Promise<ChatMessage>;
+    /**
+     * Add a system message to a conversation
+     *
+     * @param conversationId - Conversation to add the message to
+     * @param content - Message content
+     * @param metadata - Optional metadata
+     * @returns The created message
+     */
+    addSystemMessage(conversationId: string, content: string, metadata?: Record<string, unknown>): Promise<ChatMessage>;
+    /**
+     * Get messages for a conversation
+     *
+     * @param filter - Message filter options
+     * @returns Array of messages matching the filter
+     *
+     * @example
+     * ```typescript
+     * const messages = await chatService.getMessages({
+     *   conversationId: 'conv-123',
+     *   limit: 50,
+     *   senderType: 'user',
+     * });
+     * ```
+     */
+    getMessages(filter: ChatMessageFilter): Promise<ChatMessage[]>;
+    /**
+     * Get a single message by ID
+     *
+     * @param conversationId - Conversation ID
+     * @param messageId - Message ID
+     * @returns The message or null if not found
+     */
+    getMessage(conversationId: string, messageId: string): Promise<ChatMessage | null>;
+    /**
+     * Update metadata on an existing message (partial merge).
+     *
+     * Merges the provided metadata fields into the message's existing metadata
+     * and persists the change to disk. Used by the NOTIFY reconciliation system
+     * to track Slack delivery status on chat messages.
+     *
+     * @param conversationId - Conversation the message belongs to
+     * @param messageId - ID of the message to update
+     * @param metadataPatch - Partial metadata to merge into existing metadata
+     * @returns The updated message, or null if message not found
+     */
+    updateMessageMetadata(conversationId: string, messageId: string, metadataPatch: Record<string, unknown>): Promise<ChatMessage | null>;
+    /**
+     * Find all messages with pending Slack delivery within a time window.
+     *
+     * Scans all conversations for messages where `slackDeliveryStatus === 'pending'`
+     * and `slackChannelId` is present, filtering out messages older than `maxAgeMs`.
+     * Used by NotifyReconciliationService to find messages that need retry.
+     *
+     * @param maxAgeMs - Maximum message age in milliseconds
+     * @returns Array of messages with pending Slack delivery
+     */
+    getMessagesWithPendingSlackDelivery(maxAgeMs: number): Promise<ChatMessage[]>;
+    /**
+     * Get all conversations
+     *
+     * @param filter - Optional filter options
+     * @returns Array of conversations
+     *
+     * @example
+     * ```typescript
+     * const conversations = await chatService.getConversations({
+     *   includeArchived: false,
+     *   search: 'project',
+     * });
+     * ```
+     */
+    getConversations(filter?: ConversationFilter): Promise<ChatConversation[]>;
+    /**
+     * Get a single conversation by ID
+     *
+     * @param id - Conversation ID
+     * @returns The conversation or null if not found
+     */
+    getConversation(id: string): Promise<ChatConversation | null>;
+    /**
+     * Create a new conversation
+     *
+     * @param title - Optional title for the conversation
+     * @returns The created conversation
+     *
+     * @example
+     * ```typescript
+     * const conversation = await chatService.createNewConversation('Project Discussion');
+     * ```
+     */
+    createNewConversation(title?: string, idOverride?: string): Promise<ChatConversation>;
+    /**
+     * Update a conversation's title
+     *
+     * @param id - Conversation ID
+     * @param title - New title
+     * @returns The updated conversation
+     * @throws ConversationNotFoundError if conversation doesn't exist
+     */
+    updateConversationTitle(id: string, title: string): Promise<ChatConversation>;
+    /**
+     * Archive a conversation
+     *
+     * @param id - Conversation ID
+     * @throws ConversationNotFoundError if conversation doesn't exist
+     */
+    archiveConversation(id: string): Promise<void>;
+    /**
+     * Unarchive a conversation
+     *
+     * @param id - Conversation ID
+     * @throws ConversationNotFoundError if conversation doesn't exist
+     */
+    unarchiveConversation(id: string): Promise<void>;
+    /**
+     * Delete a conversation and all its messages
+     *
+     * @param id - Conversation ID
+     */
+    deleteConversation(id: string): Promise<void>;
+    /**
+     * Clear all messages from a conversation
+     *
+     * @param id - Conversation ID
+     */
+    clearConversation(id: string): Promise<void>;
+    /**
+     * Get the current/active conversation (most recently updated non-archived)
+     *
+     * @returns The most recent active conversation or null
+     */
+    getCurrentConversation(): Promise<ChatConversation | null>;
+    /**
+     * Emit typing indicator event
+     *
+     * @param conversationId - Conversation ID
+     * @param sender - Sender information
+     * @param isTyping - Whether the sender is typing
+     */
+    emitTypingIndicator(conversationId: string, sender: ChatSender, isTyping: boolean): void;
+    /**
+     * Emit a chat message event
+     *
+     * @param message - The message to emit
+     */
+    private emitChatMessageEvent;
+    /**
+     * Emit a conversation updated event
+     *
+     * @param conversation - The updated conversation
+     */
+    private emitConversationUpdatedEvent;
+    /**
+     * Get statistics about chat usage
+     *
+     * @returns Statistics object
+     */
+    getStatistics(): Promise<{
+        totalConversations: number;
+        activeConversations: number;
+        archivedConversations: number;
+        totalMessages: number;
+    }>;
+    /**
+     * Load all conversations from disk
+     */
+    private loadConversations;
+    /**
+     * Save a conversation and its messages to disk using atomic write (write-to-tmp + rename).
+     * Serialized per conversation to prevent concurrent writes from corrupting the file.
+     *
+     * @param conversation - Conversation to save
+     */
+    private saveConversation;
+    /**
+     * Perform the actual atomic file write for a conversation.
+     * Writes to a temporary file first, then renames to the final path to prevent corruption.
+     *
+     * @param conversation - Conversation to save
+     */
+    private doSaveConversation;
+    /**
+     * Save a message to the in-memory store and persist to disk
+     *
+     * @param message - Message to save
+     */
+    private saveMessage;
+    /**
+     * Update a conversation's metadata after adding a message
+     *
+     * @param conversationId - Conversation ID
+     * @param message - The added message
+     */
+    private updateConversationWithMessage;
+}
+/**
+ * Get the singleton ChatService instance
+ *
+ * @returns The ChatService instance
+ */
+export declare function getChatService(): ChatService;
+/**
+ * Reset the singleton instance (for testing)
+ */
+export declare function resetChatService(): void;
+//# sourceMappingURL=chat.service.d.ts.map

package/dist/backend/backend/src/services/chat/chat.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/chat/chat.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAMtC,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAcnB,MAAM,2BAA2B,CAAC;AAMnC;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;aACtB,cAAc,EAAE,MAAM;gBAAtB,cAAc,EAAE,MAAM;CAInD;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,aAAa,CAA4C;IACjE,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,WAAW,CAAS;IAC5B,iFAAiF;IACjF,OAAO,CAAC,YAAY,CAAyC;IAE7D;;;;OAIG;gBACS,OAAO,CAAC,EAAE,kBAAkB;IAWxC;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;;;OAIG;IACH,aAAa,IAAI,OAAO;IAIxB;;;;OAIG;YACW,iBAAiB;IAU/B;;;;;;;;;;;;;;OAcG;IACG,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwCtE;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,eAAe,CACnB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,EAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,WAAW,CAAC;IA+BvB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,gBAAgB,CACpB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,UAAU,EAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,WAAW,CAAC;IAwBvB;;;;;;;OAOG;IACG,gBAAgB,CACpB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,WAAW,CAAC;IAkBvB;;;;;;;;;;;;;;OAcG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAoCpE;;;;;;OAMG;IACG,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IASxF;;;;;;;;;;;OAWG;IACG,qBAAqB,CACzB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAmB9B;;;;;;;;;OASG;IACG,mCAAmC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAyBnF;;;;;;;;;;;;;OAaG;IACG,gBAAgB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA8BhF;;;;;OAKG;IACG,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAKnE;;;;;;;;;;OAUG;IACG,qBAAqB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAe3F;;;;;;;OAOG;IACG,uBAAuB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiBnF;;;;;OAKG;IACG,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAepD;;;;;OAKG;IACG,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAetD;;;;OAIG;IACG,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBnD;;;;OAIG;IACG,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAelD;;;;OAIG;IACG,sBAAsB,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAShE;;;;;;OAMG;IACH,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAQxF;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;;;OAIG;IACH,OAAO,CAAC,4BAA4B;IAYpC;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC;QAC7B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,qBAAqB,EAAE,MAAM,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IAwBF;;OAEG;YACW,iBAAiB;IAsB/B;;;;;OAKG;YACW,gBAAgB;IAU9B;;;;;OAKG;YACW,kBAAkB;IAOhC;;;;OAIG;YACW,WAAW;IAWzB;;;;;OAKG;YACW,6BAA6B;CAmB5C;AAQD;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAK5C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}