@rudderhq/server 0.3.6-canary.2 → 0.3.6-canary.21

package/dist/services/chats.d.ts

@@ -1,6 +1,7 @@
 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;
@@ -35,6 +36,7 @@ export declare function chatService(db: Db): {
                 priority?: string | null;
                 href: string;
             } | null;
+            conversationId: string;
             id: string;
             orgId: string;
             createdAt: Date;
@@ -42,7 +44,6 @@ export declare function chatService(db: Db): {
             entityType: string;
             entityId: string;
             metadata: Record<string, unknown> | null;
-            conversationId: string;
         }[];
         lastReadAt: Date | null;
         isPinned: boolean;
@@ -51,10 +52,10 @@ export declare function chatService(db: Db): {
         needsAttention: boolean;
         id: string;
         orgId: string;
-        createdByUserId: string | null;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
-        status: string;
+        createdByUserId: string | null;
         title: string;
         summary: string | null;
         preferredAgentId: string | null;
@@ -81,10 +82,10 @@ export declare function chatService(db: Db): {
         needsAttention: boolean;
         id: string;
         orgId: string;
-        createdByUserId: string | null;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
-        status: string;
+        createdByUserId: string | null;
         title: string;
         summary: string | null;
         preferredAgentId: string | null;
@@ -106,10 +107,10 @@ export declare function chatService(db: Db): {
         needsAttention: boolean;
         id: string;
         orgId: string;
-        createdByUserId: string | null;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
-        status: string;
+        createdByUserId: string | null;
         title: string;
         summary: string | null;
         preferredAgentId: string | null;
@@ -131,10 +132,10 @@ export declare function chatService(db: Db): {
         needsAttention: boolean;
         id: string;
         orgId: string;
-        createdByUserId: string | null;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
-        status: string;
+        createdByUserId: string | null;
         title: string;
         summary: string | null;
         preferredAgentId: string | null;
@@ -168,6 +169,7 @@ export declare function chatService(db: Db): {
                 priority?: string | null;
                 href: string;
             } | null;
+            conversationId: string;
             id: string;
             orgId: string;
             createdAt: Date;
@@ -175,7 +177,6 @@ export declare function chatService(db: Db): {
             entityType: string;
             entityId: string;
             metadata: Record<string, unknown> | null;
-            conversationId: string;
         }[];
         lastReadAt: Date | null;
         isPinned: boolean;
@@ -184,10 +185,10 @@ export declare function chatService(db: Db): {
         needsAttention: boolean;
         id: string;
         orgId: string;
-        createdByUserId: string | null;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
-        status: string;
+        createdByUserId: string | null;
         title: string;
         summary: string | null;
         preferredAgentId: string | null;
@@ -233,6 +234,7 @@ export declare function chatService(db: Db): {
                 priority?: string | null;
                 href: string;
             } | null;
+            conversationId: string;
             id: string;
             orgId: string;
             createdAt: Date;
@@ -240,7 +242,6 @@ export declare function chatService(db: Db): {
             entityType: string;
             entityId: string;
             metadata: Record<string, unknown> | null;
-            conversationId: string;
         }[];
         lastReadAt: Date | null;
         isPinned: boolean;
@@ -249,10 +250,10 @@ export declare function chatService(db: Db): {
         needsAttention: boolean;
         id: string;
         orgId: string;
-        createdByUserId: string | null;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
-        status: string;
+        createdByUserId: string | null;
         title: string;
         summary: string | null;
         preferredAgentId: string | null;
@@ -286,6 +287,7 @@ export declare function chatService(db: Db): {
                 priority?: string | null;
                 href: string;
             } | null;
+            conversationId: string;
             id: string;
             orgId: string;
             createdAt: Date;
@@ -293,7 +295,6 @@ export declare function chatService(db: Db): {
             entityType: string;
             entityId: string;
             metadata: Record<string, unknown> | null;
-            conversationId: string;
         }[];
         lastReadAt: Date | null;
         isPinned: boolean;
@@ -302,10 +303,10 @@ export declare function chatService(db: Db): {
         needsAttention: boolean;
         id: string;
         orgId: string;
-        createdByUserId: string | null;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
-        status: string;
+        createdByUserId: string | null;
         title: string;
         summary: string | null;
         preferredAgentId: string | null;
@@ -339,6 +340,7 @@ export declare function chatService(db: Db): {
                 priority?: string | null;
                 href: string;
             } | null;
+            conversationId: string;
             id: string;
             orgId: string;
             createdAt: Date;
@@ -346,7 +348,6 @@ export declare function chatService(db: Db): {
             entityType: string;
             entityId: string;
             metadata: Record<string, unknown> | null;
-            conversationId: string;
         }[];
         lastReadAt: Date | null;
         isPinned: boolean;
@@ -355,10 +356,10 @@ export declare function chatService(db: Db): {
         needsAttention: boolean;
         id: string;
         orgId: string;
-        createdByUserId: string | null;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
-        status: string;
+        createdByUserId: string | null;
         title: string;
         summary: string | null;
         preferredAgentId: string | null;
@@ -392,6 +393,7 @@ export declare function chatService(db: Db): {
                 priority?: string | null;
                 href: string;
             } | null;
+            conversationId: string;
             id: string;
             orgId: string;
             createdAt: Date;
@@ -399,7 +401,6 @@ export declare function chatService(db: Db): {
             entityType: string;
             entityId: string;
             metadata: Record<string, unknown> | null;
-            conversationId: string;
         }[];
         lastReadAt: Date | null;
         isPinned: boolean;
@@ -408,10 +409,10 @@ export declare function chatService(db: Db): {
         needsAttention: boolean;
         id: string;
         orgId: string;
-        createdByUserId: string | null;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
-        status: string;
+        createdByUserId: string | null;
         title: string;
         summary: string | null;
         preferredAgentId: string | null;
@@ -431,10 +432,10 @@ export declare function chatService(db: Db): {
     remove: (id: string) => Promise<{
         id: string;
         orgId: string;
-        createdByUserId: string | null;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
-        status: string;
+        createdByUserId: string | null;
         title: string;
         summary: string | null;
         preferredAgentId: string | null;
@@ -468,6 +469,7 @@ export declare function chatService(db: Db): {
                 priority?: string | null;
                 href: string;
             } | null;
+            conversationId: string;
             id: string;
             orgId: string;
             createdAt: Date;
@@ -475,7 +477,6 @@ export declare function chatService(db: Db): {
             entityType: string;
             entityId: string;
             metadata: Record<string, unknown> | null;
-            conversationId: string;
         }[];
         lastReadAt: Date | null;
         isPinned: boolean;
@@ -484,10 +485,10 @@ export declare function chatService(db: Db): {
         needsAttention: boolean;
         id: string;
         orgId: string;
-        createdByUserId: string | null;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
-        status: string;
+        createdByUserId: string | null;
         title: string;
         summary: string | null;
         preferredAgentId: string | null;
@@ -499,35 +500,350 @@ export declare function chatService(db: Db): {
         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;
+            clientMutationId: string;
+            expectedGenerationId: string | null;
+            version: number;
+            position: number;
+            activeGenerationId: string | null;
+            deliveryAttempts: number;
+            lastAttemptAt: Date | null;
+            lastDeliveryReason: string | null;
+            sourceMessageId: 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;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        sourceMessageId: 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;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        sourceMessageId: 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;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        sourceMessageId: 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;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        sourceMessageId: 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;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        sourceMessageId: 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;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        sourceMessageId: 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;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        sourceMessageId: 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;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        sourceMessageId: 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;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        sourceMessageId: 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;
+        clientMutationId: string;
+        expectedGenerationId: string | null;
+        version: number;
+        position: number;
+        activeGenerationId: string | null;
+        deliveryAttempts: number;
+        lastAttemptAt: Date | null;
+        lastDeliveryReason: string | null;
+        sourceMessageId: string | null;
+        deliveredMessageId: string | null;
+        steeredAt: Date | null;
+        dequeuedAt: Date | null;
+    } | null>;
     listMessages: (conversationId: string, options?: {
         includeTranscript?: boolean;
     }) => Promise<{
@@ -537,10 +853,10 @@ export declare function chatService(db: Db): {
         approval: {
             id: string;
             orgId: string;
+            status: string;
             createdAt: Date;
             updatedAt: Date;
             type: string;
-            status: string;
             decisionNote: string | null;
             payload: Record<string, unknown>;
             requestedByAgentId: string | null;
@@ -549,16 +865,16 @@ export declare function chatService(db: Db): {
             decidedAt: Date | null;
         } | null;
         attachments: any[];
+        conversationId: string;
         id: string;
-        kind: string;
         orgId: string;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
-        status: string;
+        kind: string;
         body: string;
         role: string;
         approvalId: string | null;
-        conversationId: string;
         runId: string | null;
         replyingAgentId: string | null;
         chatTurnId: string | null;
@@ -589,10 +905,10 @@ export declare function chatService(db: Db): {
         approval: {
             id: string;
             orgId: string;
+            status: string;
             createdAt: Date;
             updatedAt: Date;
             type: string;
-            status: string;
             decisionNote: string | null;
             payload: Record<string, unknown>;
             requestedByAgentId: string | null;
@@ -601,16 +917,16 @@ export declare function chatService(db: Db): {
             decidedAt: Date | null;
         } | null;
         attachments: any[];
+        conversationId: string;
         id: string;
-        kind: string;
         orgId: string;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
-        status: string;
+        kind: string;
         body: string;
         role: string;
         approvalId: string | null;
-        conversationId: string;
         runId: string | null;
         replyingAgentId: string | null;
         chatTurnId: string | null;
@@ -633,10 +949,10 @@ export declare function chatService(db: Db): {
         approval: {
             id: string;
             orgId: string;
+            status: string;
             createdAt: Date;
             updatedAt: Date;
             type: string;
-            status: string;
             decisionNote: string | null;
             payload: Record<string, unknown>;
             requestedByAgentId: string | null;
@@ -645,16 +961,16 @@ export declare function chatService(db: Db): {
             decidedAt: Date | null;
         } | null;
         attachments: any[];
+        conversationId: string;
         id: string;
-        kind: string;
         orgId: string;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
-        status: string;
+        kind: string;
         body: string;
         role: string;
         approvalId: string | null;
-        conversationId: string;
         runId: string | null;
         replyingAgentId: string | null;
         chatTurnId: string | null;
@@ -668,10 +984,10 @@ export declare function chatService(db: Db): {
         approval: {
             id: string;
             orgId: string;
+            status: string;
             createdAt: Date;
             updatedAt: Date;
             type: string;
-            status: string;
             decisionNote: string | null;
             payload: Record<string, unknown>;
             requestedByAgentId: string | null;
@@ -680,16 +996,16 @@ export declare function chatService(db: Db): {
             decidedAt: Date | null;
         } | null;
         attachments: any[];
+        conversationId: string;
         id: string;
-        kind: string;
         orgId: string;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
-        status: string;
+        kind: string;
         body: string;
         role: string;
         approvalId: string | null;
-        conversationId: string;
         runId: string | null;
         replyingAgentId: string | null;
         chatTurnId: string | null;
@@ -705,10 +1021,10 @@ export declare function chatService(db: Db): {
         approval: {
             id: string;
             orgId: string;
+            status: string;
             createdAt: Date;
             updatedAt: Date;
             type: string;
-            status: string;
             decisionNote: string | null;
             payload: Record<string, unknown>;
             requestedByAgentId: string | null;
@@ -717,16 +1033,16 @@ export declare function chatService(db: Db): {
             decidedAt: Date | null;
         } | null;
         attachments: any[];
+        conversationId: string;
         id: string;
-        kind: string;
         orgId: string;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
-        status: string;
+        kind: string;
         body: string;
         role: string;
         approvalId: string | null;
-        conversationId: string;
         runId: string | null;
         replyingAgentId: string | null;
         chatTurnId: string | null;
@@ -749,6 +1065,7 @@ export declare function chatService(db: Db): {
             priority?: string | null;
             href: string;
         } | null;
+        conversationId: string;
         id: string;
         orgId: string;
         createdAt: Date;
@@ -756,7 +1073,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 +1097,7 @@ export declare function chatService(db: Db): {
                 priority?: string | null;
                 href: string;
             } | null;
+            conversationId: string;
             id: string;
             orgId: string;
             createdAt: Date;
@@ -788,7 +1105,6 @@ export declare function chatService(db: Db): {
             entityType: string;
             entityId: string;
             metadata: Record<string, unknown> | null;
-            conversationId: string;
         }[];
         lastReadAt: Date | null;
         isPinned: boolean;
@@ -797,10 +1113,10 @@ export declare function chatService(db: Db): {
         needsAttention: boolean;
         id: string;
         orgId: string;
-        createdByUserId: string | null;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
-        status: string;
+        createdByUserId: string | null;
         title: string;
         summary: string | null;
         preferredAgentId: string | null;
@@ -833,12 +1149,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: {
@@ -854,10 +1170,10 @@ export declare function chatService(db: Db): {
         approval: {
             id: string;
             orgId: string;
+            status: string;
             createdAt: Date;
             updatedAt: Date;
             type: string;
-            status: string;
             decisionNote: string | null;
             payload: Record<string, unknown>;
             requestedByAgentId: string | null;
@@ -866,16 +1182,16 @@ export declare function chatService(db: Db): {
             decidedAt: Date | null;
         } | null;
         attachments: any[];
+        conversationId: string;
         id: string;
-        kind: string;
         orgId: string;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
-        status: string;
+        kind: string;
         body: string;
         role: string;
         approvalId: string | null;
-        conversationId: string;
         runId: string | null;
         replyingAgentId: string | null;
         chatTurnId: string | null;
@@ -886,10 +1202,10 @@ export declare function chatService(db: Db): {
         permissions: import("./agent-permissions.js").NormalizedAgentPermissions;
         id: string;
         orgId: string;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
         name: string;
-        status: string;
         title: string | null;
         agentRuntimeType: string;
         metadata: Record<string, unknown> | null;
@@ -906,6 +1222,7 @@ export declare function chatService(db: Db): {
         workspaceKey: string | null;
         lastHeartbeatAt: Date | null;
     } & {
+        shortRef: string;
         urlKey: string;
     }, "workspaceKey"> | import("./issues.helpers.js").IssueWithLabels | ({
         logoAssetId: string | null;
@@ -939,10 +1256,10 @@ export declare function chatService(db: Db): {
     }) => Promise<{
         id: string;
         orgId: string;
+        status: string;
         createdAt: Date;
         updatedAt: Date;
         type: string;
-        status: string;
         decisionNote: string | null;
         payload: Record<string, unknown>;
         requestedByAgentId: string | null;
@@ -962,10 +1279,10 @@ export declare function chatService(db: Db): {
             approval: {
                 id: string;
                 orgId: string;
+                status: string;
                 createdAt: Date;
                 updatedAt: Date;
                 type: string;
-                status: string;
                 decisionNote: string | null;
                 payload: Record<string, unknown>;
                 requestedByAgentId: string | null;
@@ -974,16 +1291,16 @@ export declare function chatService(db: Db): {
                 decidedAt: Date | null;
             } | null;
             attachments: any[];
+            conversationId: string;
             id: string;
-            kind: string;
             orgId: string;
+            status: string;
             createdAt: Date;
             updatedAt: Date;
-            status: string;
+            kind: string;
             body: string;
             role: string;
             approvalId: string | null;
-            conversationId: string;
             runId: string | null;
             replyingAgentId: string | null;
             chatTurnId: string | null;
@@ -997,10 +1314,10 @@ export declare function chatService(db: Db): {
             approval: {
                 id: string;
                 orgId: string;
+                status: string;
                 createdAt: Date;
                 updatedAt: Date;
                 type: string;
-                status: string;
                 decisionNote: string | null;
                 payload: Record<string, unknown>;
                 requestedByAgentId: string | null;
@@ -1009,16 +1326,16 @@ export declare function chatService(db: Db): {
                 decidedAt: Date | null;
             } | null;
             attachments: any[];
+            conversationId: string;
             id: string;
-            kind: string;
             orgId: string;
+            status: string;
             createdAt: Date;
             updatedAt: Date;
-            status: string;
+            kind: string;
             body: string;
             role: string;
             approvalId: string | null;
-            conversationId: string;
             runId: string | null;
             replyingAgentId: string | null;
             chatTurnId: string | null;