@indexnetwork/protocol 1.26.2 → 1.26.3-rc.224.1

package/dist/opportunity/opportunity.tools.js

@@ -2,9 +2,10 @@ import { z } from "zod";
 import { requestContext } from "../shared/observability/request-context.js";
 import { success, error, UUID_REGEX } from "../shared/agent/tool.helpers.js";
 import { MINIMAL_MAIN_TEXT_MAX_CHARS, getPrimaryActionLabel, SECONDARY_ACTION_LABEL } from "./opportunity.labels.js";
-import { viewerCentricCardSummary, narratorRemarkFromReasoning } from "./opportunity.presentation.js";
+import { viewerCentricCardSummary, narratorRemarkFromReasoning, stripUuids } from "./opportunity.presentation.js";
 import { runDiscoverFromQuery, continueDiscovery } from "./opportunity.discover.js";
-import { OpportunityPresenter } from "./opportunity.presenter.js";
+import { OpportunityPresenter, gatherPresenterContext } from "./opportunity.presenter.js";
+import { stripLeadingNarratorName } from "./feed/feed.graph.js";
 import { protocolLogger } from "../shared/observability/protocol.logger.js";
 import { selectByComposition, deduplicateByPerson } from "./opportunity.utils.js";
 import { mergePendingQuestions } from "./opportunity.pending-questions.js";
@@ -1230,75 +1231,230 @@ export function createOpportunityTools(defineTool, deps) {
                 if (user)
                     userMap.set(userId, user);
             });
+            const isDigestMode = context.isMcp === true && query.includeDigestMarkers === true;
             const cardDataList = [];
             const seenOpportunityIds = new Set();
             const skippedIds = [];
-            for (const opp of opportunities) {
-                if (seenOpportunityIds.has(opp.id))
-                    continue;
-                seenOpportunityIds.add(opp.id);
-                try {
-                    const counterpartActor = opp.actors.find((a) => a.userId !== context.userId && a.role !== "introducer");
-                    const counterpartUserId = counterpartActor?.userId;
-                    if (!counterpartUserId)
+            if (isDigestMode) {
+                // ── Digest mode: use LLM presenter for rich, second-person card text ──
+                const presenter = new OpportunityPresenter();
+                const presenterDb = database;
+                const PRESENTER_CONCURRENCY = 6;
+                for (let i = 0; i < opportunities.length; i += PRESENTER_CONCURRENCY) {
+                    const chunk = opportunities.slice(i, i + PRESENTER_CONCURRENCY);
+                    const chunkCards = await Promise.all(chunk.map(async (opp) => {
+                        if (seenOpportunityIds.has(opp.id))
+                            return null;
+                        seenOpportunityIds.add(opp.id);
+                        try {
+                            const counterpartActor = opp.actors.find((a) => a.userId !== context.userId && a.role !== "introducer");
+                            const counterpartUserId = counterpartActor?.userId;
+                            if (!counterpartUserId)
+                                return null;
+                            const viewerIsIntroducerHere = opp.actors.some((a) => a.role === "introducer" && a.userId === context.userId);
+                            const secondPartyActorForHeadline = viewerIsIntroducerHere
+                                ? opp.actors.find((a) => a.userId !== context.userId &&
+                                    a.userId !== counterpartUserId &&
+                                    a.role !== "introducer")
+                                : undefined;
+                            const introducerActor = opp.actors.find((a) => a.role === "introducer" && a.userId !== context.userId);
+                            const createdByName = opp.detection.createdByName;
+                            const counterpartUser = userMap.get(counterpartUserId) ?? null;
+                            const counterpartName = profileMap.get(counterpartUserId)?.identity?.name ??
+                                counterpartUser?.name ??
+                                "Someone";
+                            const introducerName = createdByName ??
+                                (introducerActor
+                                    ? (profileMap.get(introducerActor.userId)?.identity?.name ?? null)
+                                    : null);
+                            const introducerUser = introducerActor
+                                ? userMap.get(introducerActor.userId) ?? null
+                                : null;
+                            const secondPartyUser = secondPartyActorForHeadline
+                                ? userMap.get(secondPartyActorForHeadline.userId) ?? null
+                                : null;
+                            const secondPartyNameForHeadline = secondPartyActorForHeadline
+                                ? (profileMap.get(secondPartyActorForHeadline.userId)?.identity?.name ??
+                                    secondPartyUser?.name ??
+                                    undefined)
+                                : undefined;
+                            const viewerActor = opp.actors.find((a) => a.userId === context.userId);
+                            const viewerRole = viewerActor?.role ?? "party";
+                            const isCounterpartGhost = counterpartUser?.isGhost ?? false;
+                            // Build fallback card in case LLM presenter fails
+                            const fallbackCard = buildMinimalOpportunityCard(opp, context.userId, counterpartUserId, counterpartName, counterpartUser?.avatar ?? null, introducerName, introducerUser?.avatar ?? null, viewerName, secondPartyNameForHeadline, secondPartyUser?.avatar ?? null, secondPartyActorForHeadline?.userId, isCounterpartGhost);
+                            try {
+                                const ctx = await gatherPresenterContext(presenterDb, opp, context.userId, counterpartUserId);
+                                const presentation = await presenter.presentHomeCard({
+                                    ...ctx,
+                                    opportunityStatus: opp.status,
+                                });
+                                // Build narrator chip from presenter output
+                                let narratorChip;
+                                const introducerIsCounterpart = introducerActor && counterpartActor && introducerActor.userId === counterpartActor.userId;
+                                if (introducerActor && introducerActor.userId !== context.userId && !introducerIsCounterpart) {
+                                    const narratorName = introducerName ?? "Someone";
+                                    narratorChip = {
+                                        name: narratorName,
+                                        text: stripLeadingNarratorName(presentation.narratorRemark, narratorName),
+                                        avatar: introducerUser?.avatar ?? null,
+                                        userId: introducerActor.userId,
+                                    };
+                                }
+                                else if (introducerActor?.userId === context.userId) {
+                                    narratorChip = { name: "You", text: presentation.narratorRemark, userId: context.userId };
+                                }
+                                else {
+                                    narratorChip = { name: "Index", text: presentation.narratorRemark };
+                                }
+                                const card = {
+                                    opportunityId: opp.id,
+                                    userId: counterpartUserId,
+                                    name: counterpartName,
+                                    avatar: counterpartUser?.avatar ?? null,
+                                    mainText: stripUuids(presentation.personalizedSummary),
+                                    cta: presentation.suggestedAction,
+                                    headline: viewerIsIntroducerHere && secondPartyNameForHeadline
+                                        ? `${counterpartName} → ${secondPartyNameForHeadline}`
+                                        : presentation.headline,
+                                    primaryActionLabel: getPrimaryActionLabel(viewerRole),
+                                    secondaryActionLabel: SECONDARY_ACTION_LABEL,
+                                    mutualIntentsLabel: presentation.mutualIntentsLabel,
+                                    narratorChip,
+                                    viewerRole,
+                                    score: typeof opp.interpretation?.confidence === "number"
+                                        ? opp.interpretation.confidence
+                                        : undefined,
+                                    status: opp.status,
+                                    isGhost: isCounterpartGhost,
+                                    ...(viewerIsIntroducerHere && secondPartyNameForHeadline
+                                        ? {
+                                            secondParty: {
+                                                name: secondPartyNameForHeadline,
+                                                ...(secondPartyUser?.avatar != null ? { avatar: secondPartyUser.avatar } : {}),
+                                                ...(secondPartyActorForHeadline?.userId ? { userId: secondPartyActorForHeadline.userId } : {}),
+                                            },
+                                        }
+                                        : {}),
+                                };
+                                // Attach actionable links for MCP callers
+                                if (context.isMcp && deps.mintConnectLink) {
+                                    const viewerApproved = viewerActor?.role === "introducer" ? viewerActor.approved === true : undefined;
+                                    await attachActionableLinks(card, {
+                                        viewerId: context.userId,
+                                        viewerApproved,
+                                        counterpartUserId,
+                                        mintConnectLink: deps.mintConnectLink,
+                                        frontendUrl: deps.frontendUrl,
+                                        preferredSurface: context.clientSurface,
+                                    });
+                                }
+                                return card;
+                            }
+                            catch (presenterErr) {
+                                logger.warn("LLM presenter failed for list_opportunities digest card, using fallback", {
+                                    opportunityId: opp.id,
+                                    err: presenterErr,
+                                });
+                                // Attach links to fallback card too
+                                if (context.isMcp && deps.mintConnectLink) {
+                                    const viewerApproved = viewerActor?.role === "introducer" ? viewerActor.approved === true : undefined;
+                                    await attachActionableLinks(fallbackCard, {
+                                        viewerId: context.userId,
+                                        viewerApproved,
+                                        counterpartUserId,
+                                        mintConnectLink: deps.mintConnectLink,
+                                        frontendUrl: deps.frontendUrl,
+                                        preferredSurface: context.clientSurface,
+                                    });
+                                }
+                                return fallbackCard;
+                            }
+                        }
+                        catch (err) {
+                            logger.warn("Skipping opportunity that failed to build card", {
+                                opportunityId: opp.id,
+                                err,
+                            });
+                            skippedIds.push(opp.id);
+                            return null;
+                        }
+                    }));
+                    for (const card of chunkCards) {
+                        if (card)
+                            cardDataList.push(card);
+                    }
+                }
+            }
+            else {
+                // ── Chat mode: fast heuristic path (no LLM) ──
+                for (const opp of opportunities) {
+                    if (seenOpportunityIds.has(opp.id))
                         continue;
-                    const viewerIsIntroducerHere = opp.actors.some((a) => a.role === "introducer" && a.userId === context.userId);
-                    const secondPartyActorForHeadline = viewerIsIntroducerHere
-                        ? opp.actors.find((a) => a.userId !== context.userId &&
-                            a.userId !== counterpartUserId &&
-                            a.role !== "introducer")
-                        : undefined;
-                    const secondPartyNameForHeadline = secondPartyActorForHeadline
-                        ? (profileMap.get(secondPartyActorForHeadline.userId)?.identity?.name ??
-                            userMap.get(secondPartyActorForHeadline.userId)?.name ??
-                            undefined)
-                        : undefined;
-                    const introducerActor = opp.actors.find((a) => a.role === "introducer" && a.userId !== context.userId);
-                    const createdByName = opp.detection.createdByName;
-                    const counterpartProfile = profileMap.get(counterpartUserId) ?? null;
-                    const counterpartUser = userMap.get(counterpartUserId) ?? null;
-                    const introducerProfile = introducerActor && !createdByName
-                        ? profileMap.get(introducerActor.userId) ?? null
-                        : null;
-                    const counterpartName = counterpartProfile?.identity?.name ??
-                        counterpartUser?.name ??
-                        "Someone";
-                    const introducerName = createdByName ??
-                        (introducerActor ? introducerProfile?.identity?.name ?? null : null);
-                    const introducerUser = introducerActor
-                        ? userMap.get(introducerActor.userId) ?? null
-                        : null;
-                    const secondPartyUser = secondPartyActorForHeadline
-                        ? userMap.get(secondPartyActorForHeadline.userId) ?? null
-                        : null;
-                    const cardData = buildMinimalOpportunityCard(opp, context.userId, counterpartUserId, counterpartName, counterpartUser?.avatar ?? null, introducerName, introducerUser?.avatar ?? null, viewerName, secondPartyNameForHeadline, secondPartyUser?.avatar ?? null, secondPartyActorForHeadline?.userId);
-                    // For MCP callers (e.g. Edge Claw), mint a connect token and attach
-                    // acceptUrl + profileUrl when the (status, viewerRole) is actionable
-                    // for the viewer. Non-actionable combos (sender-on-draft,
-                    // pending-on-introducer-waiting, rejected, etc.) deliberately get
-                    // no link — the LLM would otherwise hallucinate `/api/.../connect`
-                    // URLs from the exposed opportunityId.
-                    if (context.isMcp && deps.mintConnectLink) {
-                        const viewerActor = opp.actors.find((a) => a.userId === context.userId);
-                        const viewerApproved = viewerActor?.role === "introducer" ? viewerActor.approved === true : undefined;
-                        await attachActionableLinks(cardData, {
-                            viewerId: context.userId,
-                            viewerApproved,
-                            counterpartUserId,
-                            mintConnectLink: deps.mintConnectLink,
-                            frontendUrl: deps.frontendUrl,
-                            preferredSurface: context.clientSurface,
+                    seenOpportunityIds.add(opp.id);
+                    try {
+                        const counterpartActor = opp.actors.find((a) => a.userId !== context.userId && a.role !== "introducer");
+                        const counterpartUserId = counterpartActor?.userId;
+                        if (!counterpartUserId)
+                            continue;
+                        const viewerIsIntroducerHere = opp.actors.some((a) => a.role === "introducer" && a.userId === context.userId);
+                        const secondPartyActorForHeadline = viewerIsIntroducerHere
+                            ? opp.actors.find((a) => a.userId !== context.userId &&
+                                a.userId !== counterpartUserId &&
+                                a.role !== "introducer")
+                            : undefined;
+                        const secondPartyNameForHeadline = secondPartyActorForHeadline
+                            ? (profileMap.get(secondPartyActorForHeadline.userId)?.identity?.name ??
+                                userMap.get(secondPartyActorForHeadline.userId)?.name ??
+                                undefined)
+                            : undefined;
+                        const introducerActor = opp.actors.find((a) => a.role === "introducer" && a.userId !== context.userId);
+                        const createdByName = opp.detection.createdByName;
+                        const counterpartProfile = profileMap.get(counterpartUserId) ?? null;
+                        const counterpartUser = userMap.get(counterpartUserId) ?? null;
+                        const introducerProfile = introducerActor && !createdByName
+                            ? profileMap.get(introducerActor.userId) ?? null
+                            : null;
+                        const counterpartName = counterpartProfile?.identity?.name ??
+                            counterpartUser?.name ??
+                            "Someone";
+                        const introducerName = createdByName ??
+                            (introducerActor ? introducerProfile?.identity?.name ?? null : null);
+                        const introducerUser = introducerActor
+                            ? userMap.get(introducerActor.userId) ?? null
+                            : null;
+                        const secondPartyUser = secondPartyActorForHeadline
+                            ? userMap.get(secondPartyActorForHeadline.userId) ?? null
+                            : null;
+                        const cardData = buildMinimalOpportunityCard(opp, context.userId, counterpartUserId, counterpartName, counterpartUser?.avatar ?? null, introducerName, introducerUser?.avatar ?? null, viewerName, secondPartyNameForHeadline, secondPartyUser?.avatar ?? null, secondPartyActorForHeadline?.userId);
+                        // For MCP callers (e.g. Edge Claw), mint a connect token and attach
+                        // acceptUrl + profileUrl when the (status, viewerRole) is actionable
+                        // for the viewer. Non-actionable combos (sender-on-draft,
+                        // pending-on-introducer-waiting, rejected, etc.) deliberately get
+                        // no link — the LLM would otherwise hallucinate `/api/.../connect`
+                        // URLs from the exposed opportunityId.
+                        if (context.isMcp && deps.mintConnectLink) {
+                            const viewerActor = opp.actors.find((a) => a.userId === context.userId);
+                            const viewerApproved = viewerActor?.role === "introducer" ? viewerActor.approved === true : undefined;
+                            await attachActionableLinks(cardData, {
+                                viewerId: context.userId,
+                                viewerApproved,
+                                counterpartUserId,
+                                mintConnectLink: deps.mintConnectLink,
+                                frontendUrl: deps.frontendUrl,
+                                preferredSurface: context.clientSurface,
+                            });
+                        }
+                        cardDataList.push(cardData);
+                    }
+                    catch (err) {
+                        logger.warn("Skipping opportunity that failed to build minimal card", {
+                            opportunityId: opp.id,
+                            err,
                         });
+                        skippedIds.push(opp.id);
+                        continue;
                     }
-                    cardDataList.push(cardData);
-                }
-                catch (err) {
-                    logger.warn("Skipping opportunity that failed to build minimal card", {
-                        opportunityId: opp.id,
-                        err,
-                    });
-                    skippedIds.push(opp.id);
-                    continue;
                 }
             }
             const listDebugSteps = [];