@indexnetwork/protocol 0.1.0

package/dist/agents/opportunity.presenter.js

@@ -0,0 +1,524 @@
+/**
+ * Opportunity Presenter Agent
+ *
+ * Generates personalized, second-person explanations of why an opportunity
+ * matters to the viewing user. Uses full opportunity data (interpretation,
+ * actors, profiles, intents, index) to produce headline, personalizedSummary,
+ * and suggestedAction for chat tools and user-facing surfaces.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { HumanMessage, SystemMessage } from "@langchain/core/messages";
+import { z } from "zod";
+import { Timed } from "../support/performance.js";
+import { protocolLogger } from "../support/protocol.logger.js";
+import { createModel } from "./model.config.js";
+import { viewerCentricCardSummary } from "../support/opportunity.card-text.js";
+import { stripUuids, stripIntroducerMentions } from "../support/opportunity.sanitize.js";
+const logger = protocolLogger("OpportunityPresenter");
+const LLM_TIMEOUT_MS = 20000;
+const model = createModel("opportunityPresenter");
+// ──────────────────────────────────────────────────────────────
+// SCHEMA & TYPES
+// ──────────────────────────────────────────────────────────────
+const PresentationSchema = z.object({
+    headline: z
+        .string()
+        .describe("Short, compelling headline for this opportunity (e.g., 'A React expert who needs your design skills')"),
+    personalizedSummary: z
+        .string()
+        .describe("2-3 sentence explanation using 'you' language, explaining why this opportunity is specifically valuable for the viewer based on their intents and profile"),
+    suggestedAction: z.string().describe("Brief suggested next step"),
+});
+const responseFormat = z.object({
+    presentation: PresentationSchema,
+});
+/** LLM-generated fields for home-card presentation (buttons are hardcoded by callers, not LLM-generated). */
+export const HomeCardLLMSchema = z.object({
+    headline: z
+        .string()
+        .describe("Short, compelling headline for this opportunity"),
+    personalizedSummary: z
+        .string()
+        .describe("2-3 sentence explanation in 'you' language for the main card body"),
+    suggestedAction: z
+        .string()
+        .describe("Brief suggested next step (e.g. CTA line)"),
+    narratorRemark: z
+        .string()
+        .max(80)
+        .describe("One short sentence for the narrator chip, max ~80 chars (e.g. who is suggesting and why)"),
+    mutualIntentsLabel: z
+        .string()
+        .max(48)
+        .describe("Short line for the subtitle under the other party name (e.g. '3 mutual intents', 'Shared interests', 'Aligned goals'). NEVER output '0 mutual intents' — use a qualitative phrase like 'Shared interests' when no numeric count is available."),
+});
+const homeCardResponseFormat = z.object({
+    presentation: HomeCardLLMSchema,
+});
+// ──────────────────────────────────────────────────────────────
+// SYSTEM PROMPT
+// ──────────────────────────────────────────────────────────────
+const systemPrompt = `
+You are an expert at presenting connection opportunities to users in a way that feels personal and compelling.
+
+Your goal: Given raw context about the viewer (their profile, intents), the other person(s), and why the system matched them, produce a short headline, a personalized summary, and a suggested action.
+
+Rules:
+1. Address the VIEWER directly using "you" and "your". This is for them.
+2. Be concise and compelling — not analytical or third-party. No "The source user" or "The candidate"; use names or "they" where needed.
+3. Do not leak private or confidential details. Use only the context provided.
+4. Vary user-facing nouns naturally. Do not repeatedly use the same label in one response.
+5. If possible, avoid repeating "opportunity" in both headline and summary. Prefer alternatives like "connection", "thought partner", "mutual fit", "valuable conversation", or "peer".
+6. Prefer first names in user-facing copy. Do not repeatedly use full names unless needed to disambiguate.
+
+**Introduction-originated opportunities:**
+When INTRODUCTION CONTEXT is provided, this opportunity was explicitly created by an introducer (a real person who saw value in this connection). This is NOT an automatic system discovery — someone made a deliberate judgment.
+- For ALL roles: acknowledge the introducer's role naturally. E.g., "[Introducer name] thinks you should meet [other person]" or "[Introducer name] connected you because..."
+- The introduction itself is a strong signal — treat it with the weight of a personal recommendation.
+- If the parties' intents don't obviously overlap, that's fine — the introducer saw something worth connecting. Focus on what the introducer likely saw.
+
+**Role-Specific Presentation:**
+
+**If viewer is "introducer":**
+- The viewer suggested this connection between two (or more) OTHER people. The opportunity is NOT about the viewer's own needs.
+- Headline: describe the connection between the parties (e.g., "Connecting a React expert with a startup founder").
+- Personalized summary: explain why the people YOU are introducing should meet. Reference THEIR profiles and intents, not yours. Frame it as "you're connecting X and Y because..." rather than "this matches your intent".
+- Suggested action: guide sharing (e.g., "Share this with [name] to get things started").
+- CRITICAL: Do NOT reference the introducer's own intents, skills, or needs. The introducer is the matchmaker, not a party.
+
+**If viewer is "patient" or "party":**
+- Reference their specific intents, skills, or interests that align with this opportunity.
+- If this is an introduction: mention who introduced them and frame it as a personal recommendation.
+- Headline: one short line that hooks (e.g., "[Name] thinks you should meet [Other]" or "A React expert who needs your design skills").
+- Personalized summary: 2-3 sentences. Why is this opportunity for *them*? If introduced, lead with the introduction.
+- Suggested action: encourage action ("Send a message to start the conversation" or "Share this intro").
+
+**If viewer is "agent":**
+- They are seeing this because someone already reached out.
+- If this is an introduction: mention who made the introduction.
+- Reference their skills/expertise that make them a match.
+- Headline: what the other person needs that they can provide.
+- Personalized summary: 2-3 sentences. Why someone reached out to them.
+- Suggested action: "Someone is interested in connecting — check their message" or "Review and respond".
+
+**If viewer is "peer":**
+- Mutual opportunity. Reference shared or complementary interests.
+- If this is an introduction: mention who connected them.
+- Headline: the mutual connection angle.
+- Personalized summary: 2-3 sentences. Why this is mutually valuable.
+- Suggested action: "Send an intro to connect" or "Start a conversation".
+`;
+const homeCardSystemPrompt = `
+You are an expert at presenting connection opportunities for a home feed card.
+
+Given context about the viewer, the other person, and why they were matched, produce:
+1. headline: one short hook line.
+2. personalizedSummary: 2-3 sentences in "you" language (main body text).
+3. suggestedAction: one brief suggested next step.
+4. narratorRemark: one short sentence for the narrator chip (who is suggesting and why; max ~80 chars).
+5. mutualIntentsLabel: short subtitle under the other party's name. Examples: "3 mutual intents", "Shared interests", "Aligned goals" — keep it brief. NEVER output "0 mutual intents" or any zero-count label; use a qualitative phrase instead.
+
+Rules:
+- Address the viewer with "you"/"your". Be concise and compelling.
+- narratorRemark should feel like a single sentence from the narrator (Index or a person), not meta-commentary.
+- narratorRemark is displayed with the narrator name prepended (e.g. "Index: …" or "Alice: …"). Do NOT start narratorRemark with the narrator's name or repeat it; write only the remark (e.g. "Based on your overlapping intents" or "introduced you two, sensing a valuable connection").
+- Vary wording for the match itself. Do not repeat "opportunity" across headline, summary, and narratorRemark when alternatives fit.
+- Prefer first names in user-facing copy. Avoid repeated full names unless disambiguation is necessary.
+
+**Introduction-originated opportunities (ONLY when INTRODUCTION CONTEXT is provided):**
+When INTRODUCTION CONTEXT is provided, this opportunity was explicitly created by an introducer. It was NOT automatically discovered.
+- For parties/patients/agents/peers viewing an introduction: keep the introducer signal in narratorRemark (and narrator chip), not in personalizedSummary.
+- For these introduced parties, personalizedSummary must focus ONLY on fit/value between viewer and counterpart. Do NOT mention the introducer there.
+- narratorRemark should carry the introduction signal (e.g., "saw strong alignment between you two" or "thought this connection could be valuable"), without repeating the narrator name at the start.
+- This is a personal recommendation, not an algorithm match. Frame it accordingly.
+
+**CRITICAL: NEVER include introducer names in personalizedSummary. Examples:**
+❌ WRONG: "Seref introduced you to Lucy, who is actively seeking a product co-founder..."
+✅ CORRECT: "Lucy is actively seeking a product co-founder for a niche APAC marketplace. With your expertise in UX and AI, this could be an ideal collaboration."
+
+❌ WRONG: "Bob thinks you should meet Alice because your React skills align with her needs."
+✅ CORRECT: "Alice is building a React-based platform and needs frontend expertise. Your experience with component architecture makes you a strong fit."
+
+❌ WRONG: "Jane connected you to Mark, who is looking for a designer."
+✅ CORRECT: "Mark is building a consumer app and needs design expertise. Your background in user-centered design aligns well with what he's building."
+
+Remember: The introducer's name goes ONLY in narratorRemark, NEVER in personalizedSummary.
+
+**When INTRODUCTION CONTEXT is NOT provided (system-discovered match):**
+- Do NOT use introducer-style wording. Do NOT say "you suggested", "this is an introduction you suggested", or "you suggested this connection". The system found this match; no human introducer was involved.
+- Instead, narratorRemark should describe why the match is relevant (e.g. "Based on your overlapping intents", "Your skills align with what they need").
+
+- Exception for connector/introducer: if viewer role is "introducer" (any status), this is a curation/connector card. Use:
+  - suggestedAction: one short line about sharing the intro or confirming the match.
+  - mutualIntentsLabel: a short connector label (e.g. "Connector match", "You can bridge this").
+  - headline: describe the connection between the parties (e.g., "Connecting a PhD researcher with a translator"). Do NOT reference the introducer's own needs.
+  - personalizedSummary: explain why the parties you're introducing should meet, referencing THEIR profiles and intents, not yours.
+- Exception for new-connection reveal: if viewer role is "agent", status is "accepted", and there is an introducer, this is the agent's first time seeing this opportunity. Use:
+  - suggestedAction: a short line about joining the conversation.
+`;
+// ──────────────────────────────────────────────────────────────
+// CLASS
+// ──────────────────────────────────────────────────────────────
+export class OpportunityPresenter {
+    constructor() {
+        this.model = model.withStructuredOutput(responseFormat, {
+            name: "opportunity_presenter",
+        });
+        this.homeCardModel = model.withStructuredOutput(homeCardResponseFormat, {
+            name: "opportunity_presenter_home_card",
+        });
+    }
+    async invokeWithTimeout(targetModel, messages) {
+        const timeoutReason = `LLM invoke timed out after ${LLM_TIMEOUT_MS}ms`;
+        const controller = new AbortController();
+        let timeoutId;
+        const invokePromise = targetModel.invoke(messages, {
+            signal: controller.signal,
+        });
+        const timeoutPromise = new Promise((_, reject) => {
+            timeoutId = setTimeout(() => {
+                controller.abort(timeoutReason);
+                reject(new Error(timeoutReason));
+            }, LLM_TIMEOUT_MS);
+        });
+        try {
+            return await Promise.race([invokePromise, timeoutPromise]);
+        }
+        finally {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+        }
+    }
+    /**
+     * Generate personalized presentation for a single opportunity.
+     */
+    async present(input) {
+        const introContext = input.isIntroduction
+            ? `\nINTRODUCTION CONTEXT: This opportunity was created by an explicit introduction from ${input.introducerName ?? "someone in the community"}. It was NOT discovered automatically — a real person made this connection.\n`
+            : "";
+        const humanContent = `
+VIEWER (the person seeing this opportunity):
+${input.viewerContext}
+
+OTHER PARTY:
+${input.otherPartyContext}
+
+MATCH CONTEXT:
+- Category: ${input.category}
+- Confidence: ${input.confidence}
+- Why we matched: ${input.matchReasoning}
+- Signals: ${input.signalsSummary}
+${introContext}
+COMMUNITY: ${input.indexName}
+Viewer's role in this opportunity: ${input.viewerRole}
+
+Produce headline, personalizedSummary (2-3 sentences in "you" language), and suggestedAction.
+`;
+        try {
+            const messages = [
+                new SystemMessage(systemPrompt),
+                new HumanMessage(humanContent),
+            ];
+            const result = await this.invokeWithTimeout(this.model, messages);
+            const parsed = responseFormat.parse(result);
+            parsed.presentation.personalizedSummary = stripUuids(parsed.presentation.personalizedSummary);
+            return parsed.presentation;
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            const timeoutReason = message.includes("timed out") ? message : undefined;
+            logger.warn("[OpportunityPresenter.present] LLM failed, returning fallback", {
+                message,
+                timeoutReason,
+            });
+            return {
+                headline: "A promising connection",
+                personalizedSummary: stripUuids(input.matchReasoning.slice(0, 300)),
+                suggestedAction: "Take a look and decide whether to reach out.",
+            };
+        }
+    }
+    /**
+     * Generate LLM-powered home-card content (headline, body, narrator remark, mutual-intent label).
+     * Callers append button labels from opportunity.constants.
+     */
+    async presentHomeCard(input) {
+        const mutualHint = input.mutualIntentCount != null && input.mutualIntentCount > 0
+            ? `There are ${input.mutualIntentCount} overlapping intent(s) between viewer and other party.`
+            : "Match is based on profile and intent alignment. Do not cite a numeric intent count.";
+        const introContext = input.isIntroduction
+            ? `\nINTRODUCTION CONTEXT: This opportunity was created by an explicit introduction from ${input.introducerName ?? "someone in the community"}. It was NOT discovered automatically — a real person made this connection.\n`
+            : "";
+        const humanContent = `
+VIEWER (the person seeing this opportunity):
+${input.viewerContext}
+
+OTHER PARTY:
+${input.otherPartyContext}
+
+MATCH CONTEXT:
+- Category: ${input.category}
+- Confidence: ${input.confidence}
+- Why we matched: ${input.matchReasoning}
+- Signals: ${input.signalsSummary}
+- ${mutualHint}
+${introContext}
+COMMUNITY: ${input.indexName}
+Viewer's role in this opportunity: ${input.viewerRole}
+Opportunity status: ${input.opportunityStatus ?? "pending"}
+
+Produce headline, personalizedSummary, suggestedAction, narratorRemark, and mutualIntentsLabel.
+`;
+        const isIntroducer = input.viewerRole === "introducer";
+        try {
+            const messages = [
+                new SystemMessage(homeCardSystemPrompt),
+                new HumanMessage(humanContent),
+            ];
+            const result = await this.invokeWithTimeout(this.homeCardModel, messages);
+            const parsed = homeCardResponseFormat.parse(result);
+            parsed.presentation.personalizedSummary = stripUuids(parsed.presentation.personalizedSummary);
+            parsed.presentation.narratorRemark = stripUuids(parsed.presentation.narratorRemark);
+            if (/^0\s+(mutual|overlapping)\s+intent/i.test(parsed.presentation.mutualIntentsLabel)) {
+                parsed.presentation.mutualIntentsLabel = "Shared interests";
+            }
+            if (input.isIntroduction && input.introducerName) {
+                parsed.presentation.personalizedSummary = stripIntroducerMentions(parsed.presentation.personalizedSummary, input.introducerName);
+            }
+            return parsed.presentation;
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            const timeoutReason = message.includes("timed out") ? message : undefined;
+            logger.warn("[OpportunityPresenter.presentHomeCard] LLM failed, returning fallback", {
+                message,
+                timeoutReason,
+            });
+            let fallbackSummary = stripUuids(input.matchReasoning.slice(0, 300));
+            if (input.isIntroduction && input.introducerName) {
+                fallbackSummary = stripIntroducerMentions(fallbackSummary, input.introducerName);
+            }
+            return {
+                headline: "A promising connection",
+                personalizedSummary: fallbackSummary,
+                suggestedAction: isIntroducer
+                    ? "Share this introduction to get things started."
+                    : "Take a look and decide whether to reach out.",
+                narratorRemark: "Worth a look.",
+                mutualIntentsLabel: isIntroducer
+                    ? "Connector match"
+                    : input.mutualIntentCount != null && input.mutualIntentCount > 0
+                        ? `${input.mutualIntentCount} mutual intent${input.mutualIntentCount !== 1 ? "s" : ""}`
+                        : "Shared interests",
+            };
+        }
+    }
+    /**
+     * Process multiple opportunities in parallel with bounded concurrency.
+     */
+    async presentBatch(inputs, options) {
+        const concurrency = options?.concurrency ?? 5;
+        const results = [];
+        for (let i = 0; i < inputs.length; i += concurrency) {
+            const chunk = inputs.slice(i, i + concurrency);
+            const chunkResults = await Promise.all(chunk.map((inp) => this.present(inp)));
+            results.push(...chunkResults);
+        }
+        return results;
+    }
+    /**
+     * Process multiple opportunities as home cards in parallel with bounded concurrency.
+     * Returns full home-card display contracts (headline, body, narrator remark, action labels, mutual-intent label).
+     */
+    async presentHomeCardBatch(inputs, options) {
+        const concurrency = options?.concurrency ?? 5;
+        const results = [];
+        for (let i = 0; i < inputs.length; i += concurrency) {
+            const chunk = inputs.slice(i, i + concurrency);
+            const chunkResults = await Promise.all(chunk.map((inp) => this.presentHomeCard(inp)));
+            results.push(...chunkResults);
+        }
+        return results;
+    }
+}
+__decorate([
+    Timed(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], OpportunityPresenter.prototype, "present", null);
+__decorate([
+    Timed(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], OpportunityPresenter.prototype, "presentHomeCard", null);
+__decorate([
+    Timed(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Array, Object]),
+    __metadata("design:returntype", Promise)
+], OpportunityPresenter.prototype, "presentBatch", null);
+__decorate([
+    Timed(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Array, Object]),
+    __metadata("design:returntype", Promise)
+], OpportunityPresenter.prototype, "presentHomeCardBatch", null);
+// ──────────────────────────────────────────────────────────────
+// CONTEXT GATHERER (used by tools)
+// ──────────────────────────────────────────────────────────────
+/**
+ * Gather all context needed for the presenter from the database.
+ * Fetches viewer profile, viewer intents, other party profile(s), and index in parallel.
+ *
+ * @param displayCounterpartUserId - When set (e.g. for home card), only this counterpart is included in otherPartyContext so the presenter writes about the person on the card. Omitted for introducer view (card shows both parties).
+ */
+export async function gatherPresenterContext(database, opportunity, viewerId, displayCounterpartUserId) {
+    const myActor = opportunity.actors.find((a) => a.userId === viewerId);
+    if (!myActor) {
+        throw new Error("Viewer is not an actor in this opportunity");
+    }
+    const isIntroducer = myActor.role === "introducer";
+    const otherActors = opportunity.actors.filter((a) => a.userId !== viewerId);
+    let otherPartyIds = [...new Set(otherActors.map((a) => a.userId))];
+    if (displayCounterpartUserId &&
+        !isIntroducer &&
+        otherPartyIds.includes(displayCounterpartUserId)) {
+        otherPartyIds = [displayCounterpartUserId];
+    }
+    const contextIndexId = opportunity.context?.indexId;
+    // For introducers: fetch profiles + intents for both parties; skip introducer's own intents.
+    // For other roles: fetch viewer's profile + intents and other party profiles.
+    const [viewerProfile, indexRecord, ...otherProfiles] = await Promise.all([
+        database.getProfile(viewerId),
+        contextIndexId ? database.getIndex(contextIndexId) : Promise.resolve(null),
+        ...otherPartyIds.map((uid) => database.getProfile(uid)),
+    ]);
+    // Fetch intents: for introducer, fetch each party's intents; otherwise fetch viewer's intents.
+    let viewerIntents;
+    let partyIntentsMap;
+    if (isIntroducer) {
+        const partyIntentResults = await Promise.all(otherPartyIds.map(async (uid) => ({
+            uid,
+            intents: await database.getActiveIntents(uid),
+        })));
+        partyIntentsMap = new Map(partyIntentResults.map((r) => [r.uid, r.intents]));
+    }
+    else {
+        viewerIntents = await database.getActiveIntents(viewerId);
+    }
+    let viewerContext;
+    let otherPartyContext;
+    if (isIntroducer) {
+        // Introducer view: minimal viewer context (just name + role), rich other-party context with intents
+        viewerContext = [
+            "Profile:",
+            `Name: ${viewerProfile?.identity?.name ?? "Unknown"}`,
+            "Role: You are the introducer who suggested this connection.",
+        ].join("\n");
+        const otherParts = otherPartyIds.map((uid, idx) => {
+            const profile = otherProfiles[idx];
+            const name = profile?.identity?.name ?? "Unknown";
+            const bio = profile?.identity?.bio ?? "";
+            const location = profile?.identity?.location ?? "";
+            const skills = profile?.attributes?.skills?.join(", ") ?? "";
+            const interests = profile?.attributes?.interests?.join(", ") ?? "";
+            const context = profile?.narrative?.context ?? "";
+            const intents = partyIntentsMap?.get(uid);
+            const intentLines = intents?.length
+                ? intents
+                    .slice(0, 5)
+                    .map((i) => `  - ${i.payload}${i.summary ? ` (${i.summary})` : ""}`)
+                : ["  (no active intents)"];
+            return [
+                `${name}:`,
+                `  Bio: ${bio}`,
+                location ? `  Location: ${location}` : null,
+                skills ? `  Skills: ${skills}` : null,
+                interests ? `  Interests: ${interests}` : null,
+                context ? `  Context: ${context}` : null,
+                `  Active intents:`,
+                ...intentLines,
+            ]
+                .filter(Boolean)
+                .join("\n");
+        });
+        otherPartyContext =
+            otherParts.join("\n\n") || "Parties (details not available).";
+    }
+    else {
+        // Non-introducer view: full viewer profile + intents, other party profiles
+        const viewerContextLines = [
+            "Profile:",
+            `Name: ${viewerProfile?.identity?.name ?? "Unknown"}`,
+            `Bio: ${viewerProfile?.identity?.bio ?? ""}`,
+            `Location: ${viewerProfile?.identity?.location ?? ""}`,
+            `Skills: ${viewerProfile?.attributes?.skills?.join(", ") ?? ""}`,
+            `Interests: ${viewerProfile?.attributes?.interests?.join(", ") ?? ""}`,
+            `Context: ${viewerProfile?.narrative?.context ?? ""}`,
+            "Active intents:",
+            ...(viewerIntents?.length
+                ? viewerIntents.map((i) => `- ${i.payload}${i.summary ? ` (${i.summary})` : ""}`)
+                : ["(none listed)"]),
+        ];
+        viewerContext = viewerContextLines.join("\n");
+        const otherParts = otherPartyIds.map((uid, idx) => {
+            const profile = otherProfiles[idx];
+            const name = profile?.identity?.name ?? "Unknown";
+            const bio = profile?.identity?.bio ?? "";
+            const skills = profile?.attributes?.skills?.join(", ") ?? "";
+            const interests = profile?.attributes?.interests?.join(", ") ?? "";
+            return `${name}: ${bio}. Skills: ${skills}. Interests: ${interests}`;
+        });
+        otherPartyContext =
+            otherParts.join("\n\n") || "Other party (details not available).";
+    }
+    const interp = opportunity.interpretation;
+    const signalsSummary = interp.signals?.map((s) => `${s.type}: ${s.detail ?? s.type}`).join("; ") ??
+        "Match based on profile and intent alignment.";
+    // Detect introduction-originated opportunities: only when there is an explicit introducer actor.
+    // Do NOT use detection.source === "manual" alone — system-discovered opportunities can have manual source without an introducer.
+    const introducerActor = opportunity.actors.find((a) => a.role === "introducer");
+    const isIntroduction = !!introducerActor;
+    let introducerName;
+    if (introducerActor) {
+        introducerName = opportunity.detection.createdByName;
+        if (!introducerName) {
+            const introducerProfile = await database.getProfile(introducerActor.userId);
+            introducerName = introducerProfile?.identity?.name ?? undefined;
+        }
+    }
+    const counterpartName = otherPartyIds.length === 1 && otherProfiles[0]
+        ? otherProfiles[0]?.identity?.name?.trim()
+        : undefined;
+    const viewerNameForFilter = viewerProfile?.identity?.name?.trim();
+    const matchReasoning = counterpartName && interp.reasoning
+        ? viewerCentricCardSummary(interp.reasoning, counterpartName, 400, viewerNameForFilter, introducerName)
+        : stripUuids(interp.reasoning);
+    const result = {
+        viewerContext,
+        otherPartyContext,
+        matchReasoning,
+        category: interp.category ?? "connection",
+        confidence: typeof interp.confidence === "number"
+            ? interp.confidence
+            : parseFloat(String(interp.confidence ?? 0)) || 0,
+        signalsSummary,
+        indexName: indexRecord?.title ?? contextIndexId ?? "",
+        viewerRole: myActor.role ?? "party",
+        isIntroduction,
+        introducerName,
+    };
+    return result;
+}
+//# sourceMappingURL=opportunity.presenter.js.map

package/dist/agents/opportunity.presenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunity.presenter.js","sourceRoot":"","sources":["../../src/agents/opportunity.presenter.ts"],"names":[],"mappings":"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"}

package/dist/agents/profile.generator.d.ts

@@ -0,0 +1,67 @@
+import { z } from "zod/v4";
+declare const responseFormat: z.ZodObject<{
+    identity: z.ZodObject<{
+        name: z.ZodString;
+        bio: z.ZodString;
+        location: z.ZodString;
+    }, z.core.$strip>;
+    narrative: z.ZodObject<{
+        context: z.ZodString;
+    }, z.core.$strip>;
+    attributes: z.ZodObject<{
+        interests: z.ZodArray<z.ZodString>;
+        skills: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type Profile = z.infer<typeof responseFormat>;
+export type ProfileDocument = Profile & {
+    userId: string;
+    embedding: number[] | number[][] | null;
+};
+export declare class ProfileGenerator {
+    private model;
+    constructor();
+    private toString;
+    invoke(input: string): Promise<{
+        output: {
+            identity: {
+                name: string;
+                bio: string;
+                location: string;
+            };
+            narrative: {
+                context: string;
+            };
+            attributes: {
+                interests: string[];
+                skills: string[];
+            };
+        };
+        textToEmbed: string;
+    }>;
+    static asTool(): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        input: z.ZodString;
+    }, z.core.$strip>, {
+        input: string;
+    }, {
+        input: string;
+    }, {
+        output: {
+            identity: {
+                name: string;
+                bio: string;
+                location: string;
+            };
+            narrative: {
+                context: string;
+            };
+            attributes: {
+                interests: string[];
+                skills: string[];
+            };
+        };
+        textToEmbed: string;
+    }, unknown, "profileGenerator">;
+}
+export {};
+//# sourceMappingURL=profile.generator.d.ts.map

package/dist/agents/profile.generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.generator.d.ts","sourceRoot":"","sources":["../../src/agents/profile.generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAsB3B,QAAA,MAAM,cAAc;;;;;;;;;;;;;iBAalB,CAAC;AAEH,KAAK,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9C,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,GAAG,IAAI,CAAA;CAAE,CAAC;AAEpG,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAM;;IAOnB,OAAO,CAAC,QAAQ;IAiBH,MAAM,CAAC,KAAK,EAAE,MAAM;;;;;;;;;;;;;;;;;WAgBnB,MAAM;;;;;;;;;;;;;;;;;;;;;;;CAerB"}