@rudderhq/server 0.3.6-canary.9 → 0.4.0

package/dist/services/chats.d.ts

@@ -1,11 +1,19 @@
 import type { Db } from "@rudderhq/db";
-import { approvals, chatConversations } from "@rudderhq/db";
-import { type ChatStreamTranscriptEntry } from "@rudderhq/shared";
+import { approvals, chatConversations, chatGenerations } from "@rudderhq/db";
+import { type ChatQueuedMessagePayload, type ChatStreamTranscriptEntry } from "@rudderhq/shared";
+type ChatGenerationRow = typeof chatGenerations.$inferSelect;
 type ConversationSummaryCursor = {
     activityAt: Date;
     title: string;
     threadKey: string;
 };
+type ConversationSourceMetadata = {
+    source: "agent_integration";
+    provider: string;
+    integrationId: string;
+    externalChatId: string;
+    externalChatType: string;
+};
 type ApprovalRow = typeof approvals.$inferSelect;
 export declare function chatService(db: Db): {
     list: (orgId: string, options?: {
@@ -35,6 +43,7 @@ export declare function chatService(db: Db): {
                 priority?: string | null;
                 href: string;
             } | null;
+            conversationId: string;
             id: string;
             orgId: string;
             createdAt: Date;
@@ -42,8 +51,9 @@ export declare function chatService(db: Db): {
             entityType: string;
             entityId: string;
             metadata: Record<string, unknown> | null;
-            conversationId: string;
         }[];
+        sourceMetadata: ConversationSourceMetadata | null;
+        mutability: "native_chat" | "external_bound_chat" | "native_fork_from_external";
         lastReadAt: Date | null;
         isPinned: boolean;
         unreadCount: number;
@@ -63,6 +73,9 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        forkedFromConversationId: string | null;
+        forkedFromMessageId: string | null;
+        forkRootConversationId: string | null;
         lastMessageAt: Date | null;
     }[]>;
     listSummaries: (orgId: string, options?: {
@@ -74,6 +87,8 @@ export declare function chatService(db: Db): {
         latestReplyPreview: string | null;
         latestUserMessagePreview: string | null;
         userMessageCount: number;
+        sourceMetadata: ConversationSourceMetadata | null;
+        mutability: "native_chat" | "external_bound_chat" | "native_fork_from_external";
         lastReadAt: Date | null;
         isPinned: boolean;
         unreadCount: number;
@@ -93,12 +108,17 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        forkedFromConversationId: string | null;
+        forkedFromMessageId: string | null;
+        forkRootConversationId: string | null;
         lastMessageAt: Date | null;
     }[]>;
     listPinnedSummaries: (orgId: string, userId: string) => Promise<{
         latestReplyPreview: string | null;
         latestUserMessagePreview: string | null;
         userMessageCount: number;
+        sourceMetadata: ConversationSourceMetadata | null;
+        mutability: "native_chat" | "external_bound_chat" | "native_fork_from_external";
         lastReadAt: Date | null;
         isPinned: boolean;
         unreadCount: number;
@@ -118,12 +138,17 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        forkedFromConversationId: string | null;
+        forkedFromMessageId: string | null;
+        forkRootConversationId: string | null;
         lastMessageAt: Date | null;
     }[]>;
     listSummariesByIds: (orgId: string, conversationIds: string[], userId?: string | null) => Promise<{
         latestReplyPreview: string | null;
         latestUserMessagePreview: string | null;
         userMessageCount: number;
+        sourceMetadata: ConversationSourceMetadata | null;
+        mutability: "native_chat" | "external_bound_chat" | "native_fork_from_external";
         lastReadAt: Date | null;
         isPinned: boolean;
         unreadCount: number;
@@ -143,6 +168,9 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        forkedFromConversationId: string | null;
+        forkedFromMessageId: string | null;
+        forkRootConversationId: string | null;
         lastMessageAt: Date | null;
     }[]>;
     getById: (id: string, userId?: string | null) => Promise<{
@@ -168,6 +196,7 @@ export declare function chatService(db: Db): {
                 priority?: string | null;
                 href: string;
             } | null;
+            conversationId: string;
             id: string;
             orgId: string;
             createdAt: Date;
@@ -175,8 +204,9 @@ export declare function chatService(db: Db): {
             entityType: string;
             entityId: string;
             metadata: Record<string, unknown> | null;
-            conversationId: string;
         }[];
+        sourceMetadata: ConversationSourceMetadata | null;
+        mutability: "native_chat" | "external_bound_chat" | "native_fork_from_external";
         lastReadAt: Date | null;
         isPinned: boolean;
         unreadCount: number;
@@ -196,6 +226,9 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        forkedFromConversationId: string | null;
+        forkedFromMessageId: string | null;
+        forkRootConversationId: string | null;
         lastMessageAt: Date | null;
     } | null>;
     create: (orgId: string, data: {
@@ -233,6 +266,7 @@ export declare function chatService(db: Db): {
                 priority?: string | null;
                 href: string;
             } | null;
+            conversationId: string;
             id: string;
             orgId: string;
             createdAt: Date;
@@ -240,8 +274,9 @@ export declare function chatService(db: Db): {
             entityType: string;
             entityId: string;
             metadata: Record<string, unknown> | null;
-            conversationId: string;
         }[];
+        sourceMetadata: ConversationSourceMetadata | null;
+        mutability: "native_chat" | "external_bound_chat" | "native_fork_from_external";
         lastReadAt: Date | null;
         isPinned: boolean;
         unreadCount: number;
@@ -261,6 +296,9 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        forkedFromConversationId: string | null;
+        forkedFromMessageId: string | null;
+        forkRootConversationId: string | null;
         lastMessageAt: Date | null;
     } | null>;
     update: (id: string, patch: Partial<typeof chatConversations.$inferInsert>) => Promise<{
@@ -286,6 +324,7 @@ export declare function chatService(db: Db): {
                 priority?: string | null;
                 href: string;
             } | null;
+            conversationId: string;
             id: string;
             orgId: string;
             createdAt: Date;
@@ -293,8 +332,9 @@ export declare function chatService(db: Db): {
             entityType: string;
             entityId: string;
             metadata: Record<string, unknown> | null;
-            conversationId: string;
         }[];
+        sourceMetadata: ConversationSourceMetadata | null;
+        mutability: "native_chat" | "external_bound_chat" | "native_fork_from_external";
         lastReadAt: Date | null;
         isPinned: boolean;
         unreadCount: number;
@@ -314,9 +354,12 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        forkedFromConversationId: string | null;
+        forkedFromMessageId: string | null;
+        forkRootConversationId: string | null;
         lastMessageAt: Date | null;
     } | null>;
-    updateDefaultTitle: (id: string, title: string) => Promise<{
+    updateDefaultTitle: (id: string, title: string, expectedCurrentTitle?: string) => Promise<{
         primaryIssue: {
             id: string;
             identifier: string | null;
@@ -339,6 +382,7 @@ export declare function chatService(db: Db): {
                 priority?: string | null;
                 href: string;
             } | null;
+            conversationId: string;
             id: string;
             orgId: string;
             createdAt: Date;
@@ -346,8 +390,9 @@ export declare function chatService(db: Db): {
             entityType: string;
             entityId: string;
             metadata: Record<string, unknown> | null;
-            conversationId: string;
         }[];
+        sourceMetadata: ConversationSourceMetadata | null;
+        mutability: "native_chat" | "external_bound_chat" | "native_fork_from_external";
         lastReadAt: Date | null;
         isPinned: boolean;
         unreadCount: number;
@@ -367,6 +412,9 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        forkedFromConversationId: string | null;
+        forkedFromMessageId: string | null;
+        forkRootConversationId: string | null;
         lastMessageAt: Date | null;
     } | null>;
     replaceSystemGeneratedTitle: (id: string, expectedTitle: string, title: string) => Promise<{
@@ -392,6 +440,7 @@ export declare function chatService(db: Db): {
                 priority?: string | null;
                 href: string;
             } | null;
+            conversationId: string;
             id: string;
             orgId: string;
             createdAt: Date;
@@ -399,8 +448,9 @@ export declare function chatService(db: Db): {
             entityType: string;
             entityId: string;
             metadata: Record<string, unknown> | null;
-            conversationId: string;
         }[];
+        sourceMetadata: ConversationSourceMetadata | null;
+        mutability: "native_chat" | "external_bound_chat" | "native_fork_from_external";
         lastReadAt: Date | null;
         isPinned: boolean;
         unreadCount: number;
@@ -420,6 +470,9 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        forkedFromConversationId: string | null;
+        forkedFromMessageId: string | null;
+        forkRootConversationId: string | null;
         lastMessageAt: Date | null;
     } | null>;
     listAttachmentsForConversation: (conversationId: string) => Promise<{
@@ -443,9 +496,19 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        forkedFromConversationId: string | null;
+        forkedFromMessageId: string | null;
+        forkRootConversationId: string | null;
         lastMessageAt: Date | null;
     } | null>;
-    resolve: (id: string) => Promise<{
+    forkConversation: (input: {
+        sourceConversationId: string;
+        orgId: string;
+        userId: string;
+        sourceMessageId?: string | null;
+        title?: string | null;
+        createdByUserId: string | null;
+    }) => Promise<{
         primaryIssue: {
             id: string;
             identifier: string | null;
@@ -468,6 +531,7 @@ export declare function chatService(db: Db): {
                 priority?: string | null;
                 href: string;
             } | null;
+            conversationId: string;
             id: string;
             orgId: string;
             createdAt: Date;
@@ -475,8 +539,67 @@ export declare function chatService(db: Db): {
             entityType: string;
             entityId: string;
             metadata: Record<string, unknown> | null;
+        }[];
+        sourceMetadata: ConversationSourceMetadata | null;
+        mutability: "native_chat" | "external_bound_chat" | "native_fork_from_external";
+        lastReadAt: Date | null;
+        isPinned: boolean;
+        unreadCount: number;
+        isUnread: boolean;
+        needsAttention: boolean;
+        id: string;
+        orgId: string;
+        status: string;
+        createdAt: Date;
+        updatedAt: Date;
+        createdByUserId: string | null;
+        title: string;
+        summary: string | null;
+        preferredAgentId: string | null;
+        issueCreationMode: string;
+        planMode: boolean;
+        routedAgentId: string | null;
+        primaryIssueId: string | null;
+        resolvedAt: Date | null;
+        forkedFromConversationId: string | null;
+        forkedFromMessageId: string | null;
+        forkRootConversationId: string | null;
+        lastMessageAt: Date | null;
+    } | null>;
+    resolve: (id: string) => Promise<{
+        primaryIssue: {
+            id: string;
+            identifier: string | null;
+            title: string;
+            status: string;
+            priority: string;
+        } | null;
+        latestReplyPreview: string | null;
+        latestUserMessagePreview: string | null;
+        userMessageCount: number;
+        contextLinks: {
+            entity: {
+                type: "issue" | "project" | "agent";
+                id: string;
+                label: string;
+                subtitle: string | null;
+                identifier: string | null;
+                status: string | null;
+                description?: string | null;
+                priority?: string | null;
+                href: string;
+            } | null;
             conversationId: string;
+            id: string;
+            orgId: string;
+            createdAt: Date;
+            updatedAt: Date;
+            entityType: string;
+            entityId: string;
+            metadata: Record<string, unknown> | null;
         }[];
+        sourceMetadata: ConversationSourceMetadata | null;
+        mutability: "native_chat" | "external_bound_chat" | "native_fork_from_external";
         lastReadAt: Date | null;
         isPinned: boolean;
         unreadCount: number;
@@ -496,38 +619,356 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        forkedFromConversationId: string | null;
+        forkedFromMessageId: string | null;
+        forkRootConversationId: string | null;
         lastMessageAt: Date | null;
     } | null>;
     markRead: (conversationId: string, orgId: string, userId: string, readAt?: Date) => Promise<{
+        conversationId: string;
         id: string;
         orgId: string;
         createdAt: Date;
         updatedAt: Date;
-        conversationId: string;
         userId: string;
         lastReadAt: Date;
         pinnedAt: Date | null;
     }>;
     markUnread: (conversationId: string, orgId: string, userId: string) => Promise<{
+        conversationId: string;
         id: string;
         orgId: string;
         createdAt: Date;
         updatedAt: Date;
-        conversationId: string;
         userId: string;
         lastReadAt: Date;
         pinnedAt: Date | null;
     }>;
     setPinned: (conversationId: string, orgId: string, userId: string, pinned: boolean) => Promise<{
+        conversationId: string;
         id: string;
         orgId: string;
         createdAt: Date;
         updatedAt: Date;
-        conversationId: string;
         userId: string;
         lastReadAt: Date;
         pinnedAt: Date | null;
     }>;
+    createGeneration: (orgId: string, conversationId: string) => Promise<ChatGenerationRow>;
+    markGenerationTerminal: (generationId: string | null | undefined, status: "completed" | "failed" | "stopped" | "aborted") => Promise<{
+        id: string;
+        orgId: string;
+        conversationId: string;
+        status: string;
+        terminalReason: string | null;
+        startedAt: Date;
+        completedAt: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | null>;
+    getLatestActiveGeneration: (conversationId: string) => Promise<{
+        conversationId: string;
+        id: string;
+        orgId: string;
+        status: string;
+        createdAt: Date;
+        updatedAt: Date;
+        startedAt: Date;
+        completedAt: Date | null;
+        terminalReason: string | null;
+    }>;
+    getLatestGeneration: (conversationId: string) => Promise<{
+        conversationId: string;
+        id: string;
+        orgId: string;
+        status: string;
+        createdAt: Date;
+        updatedAt: Date;
+        startedAt: Date;
+        completedAt: Date | null;
+        terminalReason: string | null;
+    }>;
+    getQueueSnapshot: (conversationId: string, activeGenerationId?: string | null) => Promise<{
+        activeGenerationId: string;
+        items: {
+            payload: ChatQueuedMessagePayload;
+            conversationId: string;
+            id: string;
+            orgId: string;
+            status: string;
+            createdAt: Date;
+            updatedAt: Date;
+            cancelledAt: Date | null;
+            sourceMessageId: string | null;
+            clientMutationId: string;
+            expectedGenerationId: string | null;
+            version: number;
+            position: number;
+            activeGenerationId: string | null;
+            deliveryAttempts: number;
+            lastAttemptAt: Date | null;
+            lastDeliveryReason: string | null;
+            deliveredMessageId: string | null;
+            steeredAt: Date | null;
+            dequeuedAt: Date | null;
+        }[];
+    }>;
+    listQueuedMessages: (conversationId: string) => Promise<{
+        payload: ChatQueuedMessagePayload;
+        conversationId: string;
+        id: string;
+        orgId: string;
+        status: string;
+        createdAt: Date;
+        updatedAt: Date;
+        cancelledAt: Date | null;
+        sourceMessageId: string | null;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        deliveredMessageId: string | null;
+        steeredAt: Date | null;
+        dequeuedAt: Date | null;
+    }[]>;
+    createQueuedMessage: (input: {
+        orgId: string;
+        conversationId: string;
+        clientMutationId: string;
+        payload: ChatQueuedMessagePayload;
+        expectedGenerationId?: string | null;
+    }) => Promise<{
+        payload: ChatQueuedMessagePayload;
+        conversationId: string;
+        id: string;
+        orgId: string;
+        status: string;
+        createdAt: Date;
+        updatedAt: Date;
+        cancelledAt: Date | null;
+        sourceMessageId: string | null;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        deliveredMessageId: string | null;
+        steeredAt: Date | null;
+        dequeuedAt: Date | null;
+    }>;
+    updateQueuedMessage: (input: {
+        conversationId: string;
+        itemId: string;
+        version: number;
+        payload: ChatQueuedMessagePayload;
+    }) => Promise<{
+        payload: ChatQueuedMessagePayload;
+        conversationId: string;
+        id: string;
+        orgId: string;
+        status: string;
+        createdAt: Date;
+        updatedAt: Date;
+        cancelledAt: Date | null;
+        sourceMessageId: string | null;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        deliveredMessageId: string | null;
+        steeredAt: Date | null;
+        dequeuedAt: Date | null;
+    }>;
+    cancelQueuedMessage: (input: {
+        conversationId: string;
+        itemId: string;
+        version?: number | null;
+    }) => Promise<{
+        payload: ChatQueuedMessagePayload;
+        conversationId: string;
+        id: string;
+        orgId: string;
+        status: string;
+        createdAt: Date;
+        updatedAt: Date;
+        cancelledAt: Date | null;
+        sourceMessageId: string | null;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        deliveredMessageId: string | null;
+        steeredAt: Date | null;
+        dequeuedAt: Date | null;
+    }>;
+    markQueuedMessageSteerFallback: (input: {
+        conversationId: string;
+        itemId: string;
+        reason: "unsupported" | "stale_generation" | "closing";
+        activeGenerationId?: string | null;
+    }) => Promise<{
+        payload: ChatQueuedMessagePayload;
+        conversationId: string;
+        id: string;
+        orgId: string;
+        status: string;
+        createdAt: Date;
+        updatedAt: Date;
+        cancelledAt: Date | null;
+        sourceMessageId: string | null;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        deliveredMessageId: string | null;
+        steeredAt: Date | null;
+        dequeuedAt: Date | null;
+    }>;
+    claimNextQueuedMessage: (conversationId: string) => Promise<{
+        payload: ChatQueuedMessagePayload;
+        conversationId: string;
+        id: string;
+        orgId: string;
+        status: string;
+        createdAt: Date;
+        updatedAt: Date;
+        cancelledAt: Date | null;
+        sourceMessageId: string | null;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        deliveredMessageId: string | null;
+        steeredAt: Date | null;
+        dequeuedAt: Date | null;
+    } | null>;
+    releaseQueuedMessageClaim: (input: {
+        conversationId: string;
+        itemId: string;
+        reason: "delivery_failed" | "delivery_aborted" | "claim_expired";
+    }) => Promise<{
+        payload: ChatQueuedMessagePayload;
+        conversationId: string;
+        id: string;
+        orgId: string;
+        status: string;
+        createdAt: Date;
+        updatedAt: Date;
+        cancelledAt: Date | null;
+        sourceMessageId: string | null;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        deliveredMessageId: string | null;
+        steeredAt: Date | null;
+        dequeuedAt: Date | null;
+    } | null>;
+    assertQueuedMessageClaimedForDelivery: (input: {
+        conversationId: string;
+        itemId: string;
+        body: string;
+    }) => Promise<{
+        payload: ChatQueuedMessagePayload;
+        conversationId: string;
+        id: string;
+        orgId: string;
+        status: string;
+        createdAt: Date;
+        updatedAt: Date;
+        cancelledAt: Date | null;
+        sourceMessageId: string | null;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        deliveredMessageId: string | null;
+        steeredAt: Date | null;
+        dequeuedAt: Date | null;
+    }>;
+    markQueuedMessageRunning: (input: {
+        conversationId: string;
+        itemId: string;
+        sourceMessageId: string;
+    }) => Promise<{
+        payload: ChatQueuedMessagePayload;
+        conversationId: string;
+        id: string;
+        orgId: string;
+        status: string;
+        createdAt: Date;
+        updatedAt: Date;
+        cancelledAt: Date | null;
+        sourceMessageId: string | null;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        deliveredMessageId: string | null;
+        steeredAt: Date | null;
+        dequeuedAt: Date | null;
+    }>;
+    markQueuedMessageDeliveryTerminal: (input: {
+        conversationId: string;
+        itemId: string;
+        status: "completed" | "failed" | "stopped" | "aborted";
+    }) => Promise<{
+        payload: ChatQueuedMessagePayload;
+        conversationId: string;
+        id: string;
+        orgId: string;
+        status: string;
+        createdAt: Date;
+        updatedAt: Date;
+        cancelledAt: Date | null;
+        sourceMessageId: string | null;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        deliveredMessageId: string | null;
+        steeredAt: Date | null;
+        dequeuedAt: Date | null;
+    } | null>;
     listMessages: (conversationId: string, options?: {
         includeTranscript?: boolean;
     }) => Promise<{
@@ -549,6 +990,7 @@ export declare function chatService(db: Db): {
             decidedAt: Date | null;
         } | null;
         attachments: any[];
+        conversationId: string;
         id: string;
         orgId: string;
         status: string;
@@ -558,7 +1000,6 @@ export declare function chatService(db: Db): {
         body: string;
         role: string;
         approvalId: string | null;
-        conversationId: string;
         runId: string | null;
         replyingAgentId: string | null;
         chatTurnId: string | null;
@@ -601,6 +1042,7 @@ export declare function chatService(db: Db): {
             decidedAt: Date | null;
         } | null;
         attachments: any[];
+        conversationId: string;
         id: string;
         orgId: string;
         status: string;
@@ -610,7 +1052,6 @@ export declare function chatService(db: Db): {
         body: string;
         role: string;
         approvalId: string | null;
-        conversationId: string;
         runId: string | null;
         replyingAgentId: string | null;
         chatTurnId: string | null;
@@ -645,6 +1086,7 @@ export declare function chatService(db: Db): {
             decidedAt: Date | null;
         } | null;
         attachments: any[];
+        conversationId: string;
         id: string;
         orgId: string;
         status: string;
@@ -654,7 +1096,6 @@ export declare function chatService(db: Db): {
         body: string;
         role: string;
         approvalId: string | null;
-        conversationId: string;
         runId: string | null;
         replyingAgentId: string | null;
         chatTurnId: string | null;
@@ -680,6 +1121,7 @@ export declare function chatService(db: Db): {
             decidedAt: Date | null;
         } | null;
         attachments: any[];
+        conversationId: string;
         id: string;
         orgId: string;
         status: string;
@@ -689,7 +1131,6 @@ export declare function chatService(db: Db): {
         body: string;
         role: string;
         approvalId: string | null;
-        conversationId: string;
         runId: string | null;
         replyingAgentId: string | null;
         chatTurnId: string | null;
@@ -717,6 +1158,7 @@ export declare function chatService(db: Db): {
             decidedAt: Date | null;
         } | null;
         attachments: any[];
+        conversationId: string;
         id: string;
         orgId: string;
         status: string;
@@ -726,7 +1168,6 @@ export declare function chatService(db: Db): {
         body: string;
         role: string;
         approvalId: string | null;
-        conversationId: string;
         runId: string | null;
         replyingAgentId: string | null;
         chatTurnId: string | null;
@@ -749,6 +1190,7 @@ export declare function chatService(db: Db): {
             priority?: string | null;
             href: string;
         } | null;
+        conversationId: string;
         id: string;
         orgId: string;
         createdAt: Date;
@@ -756,7 +1198,6 @@ export declare function chatService(db: Db): {
         entityType: string;
         entityId: string;
         metadata: Record<string, unknown> | null;
-        conversationId: string;
     } | null>;
     setProjectContextLink: (conversationId: string, orgId: string, projectId: string | null) => Promise<{
         primaryIssue: {
@@ -781,6 +1222,7 @@ export declare function chatService(db: Db): {
                 priority?: string | null;
                 href: string;
             } | null;
+            conversationId: string;
             id: string;
             orgId: string;
             createdAt: Date;
@@ -788,8 +1230,9 @@ export declare function chatService(db: Db): {
             entityType: string;
             entityId: string;
             metadata: Record<string, unknown> | null;
-            conversationId: string;
         }[];
+        sourceMetadata: ConversationSourceMetadata | null;
+        mutability: "native_chat" | "external_bound_chat" | "native_fork_from_external";
         lastReadAt: Date | null;
         isPinned: boolean;
         unreadCount: number;
@@ -809,6 +1252,9 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        forkedFromConversationId: string | null;
+        forkedFromMessageId: string | null;
+        forkRootConversationId: string | null;
         lastMessageAt: Date | null;
     } | null>;
     createAttachment: (input: {
@@ -833,12 +1279,12 @@ export declare function chatService(db: Db): {
         createdByAgentId: string | null;
         createdByUserId: string | null;
         contentPath: string;
+        conversationId: string;
+        messageId: string;
         id: string;
         orgId: string;
         createdAt: Date;
         updatedAt: Date;
-        messageId: string;
-        conversationId: string;
         assetId: string;
     }>;
     convertToIssue: (conversationId: string, input: {
@@ -866,6 +1312,7 @@ export declare function chatService(db: Db): {
             decidedAt: Date | null;
         } | null;
         attachments: any[];
+        conversationId: string;
         id: string;
         orgId: string;
         status: string;
@@ -875,7 +1322,6 @@ export declare function chatService(db: Db): {
         body: string;
         role: string;
         approvalId: string | null;
-        conversationId: string;
         runId: string | null;
         replyingAgentId: string | null;
         chatTurnId: string | null;
@@ -975,6 +1421,7 @@ export declare function chatService(db: Db): {
                 decidedAt: Date | null;
             } | null;
             attachments: any[];
+            conversationId: string;
             id: string;
             orgId: string;
             status: string;
@@ -984,7 +1431,6 @@ export declare function chatService(db: Db): {
             body: string;
             role: string;
             approvalId: string | null;
-            conversationId: string;
             runId: string | null;
             replyingAgentId: string | null;
             chatTurnId: string | null;
@@ -1010,6 +1456,7 @@ export declare function chatService(db: Db): {
                 decidedAt: Date | null;
             } | null;
             attachments: any[];
+            conversationId: string;
             id: string;
             orgId: string;
             status: string;
@@ -1019,7 +1466,6 @@ export declare function chatService(db: Db): {
             body: string;
             role: string;
             approvalId: string | null;
-            conversationId: string;
             runId: string | null;
             replyingAgentId: string | null;
             chatTurnId: string | null;