crewly 1.20.193 → 1.20.195

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

@@ -0,0 +1,185 @@
+/**
+ * Chat Service — facade over ChatV2Service.
+ *
+ * Phase 6 of the unified-chat-message-store spec
+ * (`specs/2026-05-14-unified-chat-message-store.md`):
+ * the legacy JSON-file storage at `~/.crewly/chat/` is retired.
+ * All chat persistence and read paths now flow through the canonical
+ * `ChatV2Service` (SQLite at `~/.crewly/chat.db`). This file remains
+ * temporarily as a deprecation shim so the many legacy callers
+ * (`chat.controller.ts`, `chat.gateway.ts`, `slack-orchestrator-bridge.ts`,
+ * `notify-reconciliation.service.ts`, `message-replay.service.ts`,
+ * `index.ts`) continue to compile and run while they are migrated to
+ * call ChatV2Service directly. Each facade method translates between
+ * the legacy `ChatMessage` / `ChatConversation` DTOs and chat-v2's
+ * `ChatMessageDTO` / `ChatChannelDTO` so existing event subscribers
+ * (chat.gateway.ts) see the same shapes they always have.
+ *
+ * @module services/chat/chat.service
+ */
+import { EventEmitter } from 'events';
+import { ChatMessage, ChatConversation, ChatSender, ChatChannelType, SendMessageInput, SendMessageResult, ChatMessageFilter, ConversationFilter } from '../../types/chat.types.js';
+export declare class ConversationNotFoundError extends Error {
+    readonly conversationId: string;
+    constructor(conversationId: string);
+}
+export declare class MessageValidationError extends Error {
+    constructor(message: string);
+}
+export interface ChatServiceOptions {
+    /** @deprecated Legacy filesystem path; ignored — storage is now SQLite. */
+    chatDir?: string;
+}
+/**
+ * Deprecated façade over ChatV2Service.
+ *
+ * Preserves the public surface of the original `ChatService` so the
+ * remaining legacy callers compile unchanged. Internally every method
+ * delegates to `ChatV2Service`. The original ~/.crewly/chat/*.json
+ * storage layer has been removed.
+ *
+ * New code MUST NOT depend on this class; call `getChatV2Service()`
+ * directly. Phase 6c of the spec deletes this file once all callers
+ * are migrated.
+ */
+export declare class ChatService extends EventEmitter {
+    private logger;
+    private chatV2;
+    constructor(_options?: ChatServiceOptions);
+    initialize(): Promise<void>;
+    isInitialized(): boolean;
+    /**
+     * Send a user message. Idempotency via legacy callers' own
+     * metadata.clientMessageId when present.
+     */
+    sendMessage(input: SendMessageInput): Promise<SendMessageResult>;
+    /**
+     * Add an agent reply extracted from raw terminal output. The legacy
+     * regex extraction (`[RESPONSE]` / `[CHAT_RESPONSE]` markers) is gone
+     * — callers should pass already-clean content. Kept for source
+     * compatibility with `chat.gateway.processTerminalOutput`, which has
+     * no production callers post Phase 4 discovery.
+     */
+    addAgentMessage(conversationId: string, rawOutput: string, sender: ChatSender, metadata?: Record<string, unknown>): Promise<ChatMessage>;
+    /**
+     * Persist a pre-extracted markdown reply. Primary call site is the
+     * PTY `[NOTIFY]` path in `chat.gateway.processNotifyMessage`.
+     */
+    addDirectMessage(conversationId: string, content: string, sender: ChatSender, metadata?: Record<string, unknown>): Promise<ChatMessage>;
+    /**
+     * Add a server-side system note (progress markers, errors, etc.).
+     */
+    addSystemMessage(conversationId: string, content: string, metadata?: Record<string, unknown>): Promise<ChatMessage>;
+    private recordViaFacade;
+    getMessages(filter: ChatMessageFilter): Promise<ChatMessage[]>;
+    /**
+     * Count messages in a conversation, honoring the same filters as
+     * {@link getMessages}. Returns 0 for an unknown conversation (legacy
+     * contract) instead of surfacing chat-v2's 404.
+     *
+     * @param filter - Legacy message filter (`conversationId` required for a non-zero count)
+     * @returns Number of matching messages
+     */
+    getMessageCount(filter: ChatMessageFilter): Promise<number>;
+    /**
+     * Look up a single message by id within a conversation.
+     *
+     * @param conversationId - Conversation the message must belong to
+     * @param messageId - The message id
+     * @returns The legacy message, or null when absent or in another conversation
+     */
+    getMessage(conversationId: string, messageId: string): Promise<ChatMessage | null>;
+    updateMessageMetadata(_conversationId: string, messageId: string, metadataPatch: Record<string, unknown>): Promise<ChatMessage | null>;
+    getMessagesWithPendingSlackDelivery(maxAgeMs: number): Promise<ChatMessage[]>;
+    /**
+     * List conversations in the legacy shape, honoring the legacy filters:
+     * `includeArchived` (archived rows are hidden by default), `channelType`,
+     * a case-insensitive title `search`, and `offset` / `limit` pagination.
+     *
+     * @param filter - Optional legacy conversation filter
+     * @returns Matching conversations
+     */
+    getConversations(filter?: ConversationFilter): Promise<ChatConversation[]>;
+    getConversation(id: string): Promise<ChatConversation | null>;
+    createNewConversation(title?: string, idOverride?: string, _channelType?: ChatChannelType): Promise<ChatConversation>;
+    /**
+     * Rename a conversation.
+     *
+     * @param id - Conversation id
+     * @param title - New title
+     * @returns The updated conversation
+     * @throws {ConversationNotFoundError} when the conversation does not exist
+     */
+    updateConversationTitle(id: string, title: string): Promise<ChatConversation>;
+    /**
+     * Archive a conversation.
+     *
+     * @param id - Conversation id
+     * @throws {ConversationNotFoundError} when the conversation does not exist
+     */
+    archiveConversation(id: string): Promise<void>;
+    /**
+     * Unarchive a conversation.
+     *
+     * @param id - Conversation id
+     * @throws {ConversationNotFoundError} when the conversation does not exist
+     */
+    unarchiveConversation(id: string): Promise<void>;
+    /**
+     * Delete a conversation and its messages. Idempotent: deleting an
+     * unknown conversation is a no-op (legacy contract).
+     *
+     * @param id - Conversation id
+     */
+    deleteConversation(id: string): Promise<void>;
+    clearConversation(id: string): Promise<void>;
+    getCurrentConversation(): Promise<ChatConversation | null>;
+    emitTypingIndicator(conversationId: string, sender: ChatSender, isTyping: boolean): void;
+    emitProgress(conversationId: string, text: string): void;
+    getStatistics(): Promise<{
+        totalConversations: number;
+        activeConversations: number;
+        archivedConversations: number;
+        totalMessages: number;
+    }>;
+    /**
+     * Generate a conversationId for a brand-new sendMessage call that
+     * didn't supply one. Web-chat-style id; Slack callers always pass
+     * their own slack-CHANNEL-TS identifier.
+     */
+    private synthesizeConversationId;
+    /**
+     * Emit the legacy `conversation_updated` event. chat-v2 has no
+     * channel-touched event yet, so the façade remains its source and
+     * `ChatGateway` forwards it to WebSocket clients (the chat sidebar
+     * listens for it).
+     *
+     * @param conversation - The conversation in its new state
+     */
+    private emitConversationUpdated;
+    /**
+     * Re-read a conversation and emit `conversation_updated` for it.
+     * No-op when the conversation no longer exists.
+     *
+     * @param id - Conversation id
+     */
+    private emitConversationUpdatedById;
+    /**
+     * Run a chat-v2 mutation on a conversation, translating chat-v2's
+     * `channel_not_found` error into the legacy `ConversationNotFoundError`
+     * that callers (chat.controller → 404) catch by type.
+     *
+     * @param id - Conversation id
+     * @param fn - The chat-v2 operation
+     * @returns Whatever `fn` returns
+     * @throws {ConversationNotFoundError} when the conversation does not exist
+     */
+    private withConversation;
+    /**
+     * @deprecated Will be removed when the façade is retired.
+     */
+    ensureInitialized(): Promise<void>;
+}
+export declare function getChatService(options?: ChatServiceOptions): ChatService;
+export declare function resetChatService(): void;
+//# sourceMappingURL=chat.service.d.ts.map

package/dist/cli/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":"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"}