@rudderhq/server 0.3.6-canary.8 → 0.4.0

package/dist/services/messenger.d.ts

@@ -1,3 +1,11 @@
+/**
+ * @fileoverview Messenger thread aggregation service for chat, issue,
+ * approval, budget, failed-run, join-request, and custom grouped threads.
+ *
+ * @see doc/product/domains/collaboration/chat-messenger-im.md - Messenger and chat thread behavior
+ * @see doc/product/surfaces/surface-domain-map.md - surface-to-domain routing map
+ * @see doc/product/domains/control-plane/dashboard-calendar-inbox.md - operator inbox signals
+ */
 import type { Db } from "@rudderhq/db";
 import { type MessengerApprovalThreadItem, type MessengerBudgetThreadItem, type MessengerCustomGroupsResponse, type MessengerHeartbeatRunThreadItem, type MessengerIssueThreadItem, type MessengerJoinRequestThreadItem, type MessengerSystemThreadKind, type MessengerThreadDetail, type MessengerThreadSummary, type MessengerThreadSummaryPage } from "@rudderhq/shared";
 import { chatService } from "./chats.js";
@@ -20,6 +28,8 @@ type ChatConversationRow = Awaited<ReturnType<ReturnType<typeof chatService>["li
 type ChatMessageRow = Awaited<ReturnType<ReturnType<typeof chatService>["listMessages"]>>[number];
 export declare function messengerService(db: Db): {
     listCustomGroups: (orgId: string, userId: string) => Promise<MessengerCustomGroupsResponse>;
+    listThreadTitles: (orgId: string, userId: string, threadKeys: string[]) => Promise<string[]>;
+    listCustomGroupThreadTitles: (orgId: string, userId: string, groupId: string) => Promise<string[]>;
     createCustomGroup: (orgId: string, userId: string, name: string, icon?: string | null) => Promise<{
         id: string;
         orgId: string;
@@ -30,12 +40,14 @@ export declare function messengerService(db: Db): {
         collapsed: boolean;
         sortOrder: number;
         userId: string;
+        pinnedAt: Date | null;
     }>;
     createCustomGroupWithEntries: (orgId: string, userId: string, name: string, icon: string | null, threadKeys: string[]) => Promise<MessengerCustomGroupsResponse>;
     updateCustomGroup: (orgId: string, userId: string, groupId: string, patch: {
         name?: string;
         icon?: string | null;
         collapsed?: boolean;
+        pinned?: boolean;
         sortOrder?: number;
     }) => Promise<{
         id: string;
@@ -45,6 +57,7 @@ export declare function messengerService(db: Db): {
         icon: string | null;
         sortOrder: number;
         collapsed: boolean;
+        pinnedAt: Date | null;
         createdAt: Date;
         updatedAt: Date;
     }>;
@@ -58,6 +71,7 @@ export declare function messengerService(db: Db): {
         collapsed: boolean;
         sortOrder: number;
         userId: string;
+        pinnedAt: Date | null;
     }>;
     deleteCustomGroup: (orgId: string, userId: string, groupId: string) => Promise<{
         id: string;
@@ -69,6 +83,7 @@ export declare function messengerService(db: Db): {
         collapsed: boolean;
         sortOrder: number;
         userId: string;
+        pinnedAt: Date | null;
     }>;
     reorderCustomGroups: (orgId: string, userId: string, groupIds: string[]) => Promise<MessengerCustomGroupsResponse>;
     assignThreadToCustomGroup: (orgId: string, userId: string, groupId: string, threadKey: string) => Promise<{
@@ -118,7 +133,7 @@ export declare function messengerService(db: Db): {
         summary: MessengerThreadSummary;
         detail: {
             threadKey: string;
-            kind: "failed-runs";
+            kind: "budget-alerts";
             title: string;
             subtitle: string;
             preview: string | null;
@@ -129,13 +144,13 @@ export declare function messengerService(db: Db): {
             isPinned: false;
             href: string;
             description: string;
-            items: MessengerHeartbeatRunThreadItem[];
+            items: MessengerBudgetThreadItem[];
         };
     } | {
         summary: MessengerThreadSummary;
         detail: {
             threadKey: string;
-            kind: "budget-alerts";
+            kind: "failed-runs";
             title: string;
             subtitle: string;
             preview: string | null;
@@ -146,7 +161,7 @@ export declare function messengerService(db: Db): {
             isPinned: false;
             href: string;
             description: string;
-            items: MessengerBudgetThreadItem[];
+            items: MessengerHeartbeatRunThreadItem[];
         };
     } | {
         summary: MessengerThreadSummary;

package/dist/services/messenger.d.ts.map

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

package/dist/services/messenger.js

@@ -393,6 +393,7 @@ function chatSummary(conversation) {
             routedAgentId: conversation.routedAgentId,
             runtimeAgentId: conversation.chatRuntime?.runtimeAgentId ?? null,
             latestUserMessagePreview: conversation.latestUserMessagePreview,
+            ...(conversation.sourceMetadata ?? {}),
         },
     };
 }
@@ -566,7 +567,7 @@ function failedRunCard(run, agentName) {
         href: `/agents/${run.agentId}/runs/${run.id}`,
         latestActivityAt: run.updatedAt ?? run.createdAt,
         actions: [
-            buildAction("Retry", `/heartbeat-runs/${run.id}/retry`, "POST"),
+            buildAction("Retry", `/agent-runs/${run.id}/retry`, "POST"),
             buildAction("Open run", `/agents/${run.agentId}/runs/${run.id}`, "GET"),
         ],
         metadata: {
@@ -655,6 +656,16 @@ export function messengerService(db) {
     function chatConversationIdFromThreadKey(threadKey) {
         return threadKey.startsWith("chat:") ? threadKey.slice("chat:".length) : null;
     }
+    function issueIdFromThreadKey(threadKey) {
+        return threadKey.startsWith("issue:") ? threadKey.slice("issue:".length) : null;
+    }
+    function isSyntheticMessengerThreadKey(threadKey) {
+        return threadKey === "issues"
+            || threadKey === "approvals"
+            || threadKey === "failed-runs"
+            || threadKey === "budget-alerts"
+            || threadKey === "join-requests";
+    }
     async function getCustomGroupOrThrow(orgId, userId, groupId) {
         const [group] = await db
             .select()
@@ -665,15 +676,91 @@ export function messengerService(db) {
             throw notFound("Messenger custom group not found");
         return group;
     }
-    async function ensureChatThreadCanBeGrouped(orgId, userId, threadKey) {
+    async function loadIssueThreadSummaryById(orgId, userId, issueId) {
+        const lastReadAtPromise = lastReadAtForThread(db, orgId, userId, "issues");
+        const rows = (await db.execute(issueEntryRowsQuery(orgId, userId, sql `
+        where id = ${issueId}
+        limit 1
+      `)));
+        const entry = rows[0] ? issueThreadEntryFromRow(rows[0], userId) : null;
+        if (!entry)
+            return null;
+        const [card] = await buildIssueCardsForEntries(orgId, userId, [entry], "latest");
+        if (!card)
+            return null;
+        const lastReadAt = await lastReadAtPromise;
+        const issueThreadStates = await loadThreadStates(db, orgId, userId, [`issue:${issueId}`]);
+        return splitIssueSummary(card.entry, card.item, lastReadAt, issueThreadStates.get(`issue:${issueId}`) ?? null);
+    }
+    async function loadSyntheticThreadSummaryByKey(orgId, userId, threadKey) {
+        const syntheticThreadStates = loadThreadStates(db, orgId, userId, [
+            "issues",
+            "approvals",
+            "failed-runs",
+            "budget-alerts",
+            "join-requests",
+        ]);
+        switch (threadKey) {
+            case "issues": {
+                const data = await loadIssueThreadSummaryData(orgId, userId, syntheticThreadStates);
+                return data.itemCount > 0 ? data.summary : null;
+            }
+            case "approvals": {
+                const data = await loadApprovalThreadSummaryData(orgId, userId, syntheticThreadStates);
+                return data.itemCount > 0 ? data.summary : null;
+            }
+            case "failed-runs": {
+                const data = await loadFailedRunSummaryData(orgId, userId, syntheticThreadStates);
+                return data.itemCount > 0 ? data.summary : null;
+            }
+            case "budget-alerts": {
+                const data = await loadBudgetAlertData(orgId, userId, syntheticThreadStates);
+                return data.detail.items.length > 0 ? data.summary : null;
+            }
+            case "join-requests": {
+                const data = await loadJoinRequestSummaryData(orgId, userId, syntheticThreadStates);
+                return data.itemCount > 0 ? data.summary : null;
+            }
+            default:
+                return null;
+        }
+    }
+    async function findMessengerThreadSummary(orgId, userId, threadKey) {
         const conversationId = chatConversationIdFromThreadKey(threadKey);
-        if (!conversationId) {
-            throw badRequest("Only chat threads can be added to custom Messenger groups");
+        if (conversationId) {
+            const conversations = await chatsSvc.listSummariesByIds(orgId, [conversationId], userId);
+            const conversation = conversations[0];
+            return conversation ? chatSummary(conversation) : null;
         }
-        const conversations = await chatsSvc.listSummariesByIds(orgId, [conversationId], userId);
-        if (conversations.length === 0) {
-            throw notFound("Messenger chat thread not found");
+        const issueId = issueIdFromThreadKey(threadKey);
+        if (issueId) {
+            return loadIssueThreadSummaryById(orgId, userId, issueId);
         }
+        return loadSyntheticThreadSummaryByKey(orgId, userId, threadKey);
+    }
+    async function ensureMessengerThreadCanBeGrouped(orgId, userId, threadKey) {
+        const summary = await findMessengerThreadSummary(orgId, userId, threadKey);
+        if (!summary) {
+            throw notFound("Messenger thread not found");
+        }
+    }
+    async function listThreadTitles(orgId, userId, threadKeys) {
+        const titles = [];
+        for (const threadKey of [...new Set(threadKeys)]) {
+            const summary = await findMessengerThreadSummary(orgId, userId, threadKey);
+            if (summary?.title)
+                titles.push(summary.title);
+        }
+        return titles;
+    }
+    async function listCustomGroupThreadTitles(orgId, userId, groupId) {
+        await getCustomGroupOrThrow(orgId, userId, groupId);
+        const entries = await db
+            .select({ threadKey: messengerCustomGroupEntries.threadKey })
+            .from(messengerCustomGroupEntries)
+            .where(and(eq(messengerCustomGroupEntries.orgId, orgId), eq(messengerCustomGroupEntries.userId, userId), eq(messengerCustomGroupEntries.groupId, groupId)))
+            .orderBy(asc(messengerCustomGroupEntries.sortOrder), asc(messengerCustomGroupEntries.createdAt));
+        return listThreadTitles(orgId, userId, entries.map((entry) => entry.threadKey));
     }
     async function listCustomGroups(orgId, userId) {
         const [groups, entries] = await Promise.all([
@@ -681,17 +768,15 @@ export function messengerService(db) {
                 .select()
                 .from(messengerCustomGroups)
                 .where(and(eq(messengerCustomGroups.orgId, orgId), eq(messengerCustomGroups.userId, userId)))
-                .orderBy(asc(messengerCustomGroups.sortOrder), asc(messengerCustomGroups.createdAt)),
+                .orderBy(sql `${messengerCustomGroups.pinnedAt} IS NULL`, asc(messengerCustomGroups.sortOrder), asc(messengerCustomGroups.createdAt)),
             db
                 .select()
                 .from(messengerCustomGroupEntries)
                 .where(and(eq(messengerCustomGroupEntries.orgId, orgId), eq(messengerCustomGroupEntries.userId, userId)))
                 .orderBy(asc(messengerCustomGroupEntries.sortOrder), asc(messengerCustomGroupEntries.createdAt)),
         ]);
-        const chatThreadKeys = entries
+        const conversationIds = entries
             .map((entry) => entry.threadKey)
-            .filter((threadKey) => Boolean(chatConversationIdFromThreadKey(threadKey)));
-        const conversationIds = chatThreadKeys
             .map((threadKey) => chatConversationIdFromThreadKey(threadKey))
             .filter((id) => Boolean(id));
         const conversations = await chatsSvc.listSummariesByIds(orgId, conversationIds, userId);
@@ -699,11 +784,36 @@ export function messengerService(db) {
             const summary = chatSummary(conversation);
             return [summary.threadKey, summary];
         }));
+        const nonChatThreadKeys = [...new Set(entries
+                .map((entry) => entry.threadKey)
+                .filter((threadKey) => !chatConversationIdFromThreadKey(threadKey)))];
+        const issueThreadKeys = nonChatThreadKeys.filter((threadKey) => Boolean(issueIdFromThreadKey(threadKey)));
+        if (nonChatThreadKeys.length > 0) {
+            const syntheticThreadKeys = nonChatThreadKeys.filter((threadKey) => !issueIdFromThreadKey(threadKey));
+            const [issueSummaries, syntheticSummaries] = await Promise.all([
+                Promise.all(issueThreadKeys.map(async (threadKey) => {
+                    const issueId = issueIdFromThreadKey(threadKey);
+                    return issueId ? loadIssueThreadSummaryById(orgId, userId, issueId) : null;
+                })),
+                Promise.all(syntheticThreadKeys.map((threadKey) => loadSyntheticThreadSummaryByKey(orgId, userId, threadKey))),
+            ]);
+            for (const summary of issueSummaries) {
+                if (summary)
+                    summaryByThreadKey.set(summary.threadKey, summary);
+            }
+            for (const summary of syntheticSummaries) {
+                if (summary)
+                    summaryByThreadKey.set(summary.threadKey, summary);
+            }
+        }
         const staleEntryIds = [];
         const entriesByGroupId = new Map();
         for (const entry of entries) {
             const summary = summaryByThreadKey.get(entry.threadKey);
             if (!summary) {
+                if (isSyntheticMessengerThreadKey(entry.threadKey)) {
+                    continue;
+                }
                 staleEntryIds.push(entry.id);
                 continue;
             }
@@ -745,6 +855,7 @@ export function messengerService(db) {
             name,
             icon,
             sortOrder: (lastGroup?.sortOrder ?? -1) + 1,
+            pinnedAt: now,
             updatedAt: now,
         })
             .returning();
@@ -755,10 +866,15 @@ export function messengerService(db) {
     }
     async function updateCustomGroup(orgId, userId, groupId, patch) {
         await getCustomGroupOrThrow(orgId, userId, groupId);
+        const { pinned, ...groupPatch } = patch;
+        const updatePatch = {
+            ...groupPatch,
+            ...(typeof pinned === "boolean" ? { pinnedAt: pinned ? new Date() : null } : {}),
+        };
         const [group] = await db
             .update(messengerCustomGroups)
             .set({
-            ...patch,
+            ...updatePatch,
             updatedAt: new Date(),
         })
             .where(and(eq(messengerCustomGroups.orgId, orgId), eq(messengerCustomGroups.userId, userId), eq(messengerCustomGroups.id, groupId)))
@@ -797,7 +913,7 @@ export function messengerService(db) {
         return listCustomGroups(orgId, userId);
     }
     async function assignThreadToCustomGroupWithClient(client, orgId, userId, groupId, threadKey) {
-        await ensureChatThreadCanBeGrouped(orgId, userId, threadKey);
+        await ensureMessengerThreadCanBeGrouped(orgId, userId, threadKey);
         const [lastEntry] = await client
             .select({ sortOrder: messengerCustomGroupEntries.sortOrder })
             .from(messengerCustomGroupEntries)
@@ -1423,7 +1539,6 @@ export function messengerService(db) {
     }
     async function loadApprovalThreadSummaryData(orgId, userId, threadStates) {
         const lastReadAt = await lastReadAtForThread(db, orgId, userId, "approvals", threadStates);
-        const approvalPredicate = eq(approvals.orgId, orgId);
         const pendingApprovalPredicate = and(eq(approvals.orgId, orgId), eq(approvals.status, "pending"));
         const [summaryRows, latestApprovalRows, latestCommentRows, unreadRows] = await Promise.all([
             db
@@ -1431,11 +1546,11 @@ export function messengerService(db) {
                 itemCount: sql `count(*)::int`,
             })
                 .from(approvals)
-                .where(approvalPredicate),
+                .where(pendingApprovalPredicate),
             db
                 .select()
                 .from(approvals)
-                .where(approvalPredicate)
+                .where(pendingApprovalPredicate)
                 .orderBy(desc(approvals.updatedAt), desc(approvals.createdAt))
                 .limit(1),
             db
@@ -1457,6 +1572,7 @@ export function messengerService(db) {
             limit 1
           ) latest_comment on true
           where ${approvals.orgId} = ${orgId}
+            and ${approvals.status} = 'pending'
           order by latest_comment.created_at desc
           limit 1
         `),
@@ -1485,7 +1601,7 @@ export function messengerService(db) {
             ? await db
                 .select()
                 .from(approvals)
-                .where(and(eq(approvals.id, latestCommentRow.approvalId), approvalPredicate))
+                .where(and(eq(approvals.id, latestCommentRow.approvalId), pendingApprovalPredicate))
                 .limit(1)
             : [];
         const candidateItems = [];
@@ -1556,7 +1672,7 @@ export function messengerService(db) {
                 needsAttention: unreadCount > 0,
                 isPinned: false,
                 href: "/messenger/system/failed-runs",
-                description: "Recent failed heartbeat runs",
+                description: "Recent failed agent runs",
                 items: chronologicalItems,
             },
         };
@@ -1947,6 +2063,8 @@ export function messengerService(db) {
     }
     return {
         listCustomGroups,
+        listThreadTitles,
+        listCustomGroupThreadTitles,
         createCustomGroup,
         createCustomGroupWithEntries,
         updateCustomGroup,