@indexnetwork/protocol 65.0.0 → 66.0.0-rc.609.1

package/dist/internal/opportunities/opportunity.presentation.js

@@ -2,16 +2,12 @@
  * The opportunity presentation cluster.
  *
  * One file for the whole path from a persisted opportunity to the copy a user
- * reads: the pure text transforms, the cache-key builders, the safe-fallback
- * pipeline, and the LLM presenter itself. They were four modules that only ever
- * called each other in one direction, and following a card's copy meant hopping
- * between them.
+ * reads: the cache-key builders and the LLM presenter itself. All user-facing
+ * copy comes from the presenter; there is no deterministic fallback.
  *
  * Sections, in dependency order:
- *   1. Pure presentation transforms
- *   2. Presentation cache keys
- *   3. Safe-presentation pipeline (fallbacks that never leak raw reasoning)
- *   4. OpportunityPresenter (LLM card and chat copy)
+ *   1. Presentation cache keys
+ *   2. OpportunityPresenter (LLM card and chat copy)
  */
 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;
@@ -22,548 +18,22 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { MINIMAL_MAIN_TEXT_MAX_CHARS } from "./opportunity.labels.js";
-import { stripUnsupportedOpportunityClaims } from "../shared/utils/claim-safety.js";
 import { HumanMessage, SystemMessage } from "@langchain/core/messages";
 import { z } from "zod";
 import { Timed } from "../shared/observability/performance.js";
-import { protocolLogger } from "../shared/observability/protocol.logger.js";
 import { createStructuredModel } from "../shared/agent/model.config.js";
-/**
- * Generate presentation copy for an opportunity based on viewer context.
- * Pure function — no side effects, no database access.
- */
-export function presentOpportunity(opp, viewerId, otherPartyInfo, format) {
-    const myActor = opp.actors.find((a) => a.userId === viewerId);
-    if (!myActor) {
-        throw new Error('Viewer is not an actor in this opportunity');
-    }
-    const otherName = otherPartyInfo.name;
-    const safeReasoning = stripUnsupportedOpportunityClaims(stripUuids(opp.interpretation.reasoning)) ||
-        'A promising connection.';
-    let title;
-    let description;
-    let descriptionIsReasoning = false;
-    switch (myActor.role) {
-        case 'agent':
-            title = `You can help ${otherName}`;
-            description = `Based on your expertise, ${otherName} might benefit from connecting with you.`;
-            break;
-        case 'patient':
-            title = `${otherName} might be able to help you`;
-            description = `${otherName} has skills that align with what you're looking for.`;
-            break;
-        case 'peer':
-            title = `Potential collaboration with ${otherName}`;
-            description = `You and ${otherName} have complementary interests.`;
-            break;
-        case 'mentee':
-            title = `${otherName} could mentor you`;
-            description = `${otherName} has experience that could help guide your journey.`;
-            break;
-        case 'mentor':
-            title = `${otherName} is looking for guidance`;
-            description = `Your expertise could help ${otherName} on their path.`;
-            break;
-        case 'founder':
-            title = `${otherName} might be interested in your venture`;
-            description = `${otherName}'s investment focus aligns with what you're building.`;
-            break;
-        case 'investor':
-            title = `${otherName} is building something interesting`;
-            description = `${otherName}'s venture might fit your investment thesis.`;
-            break;
-        case 'party':
-        default:
-            title = `Opportunity with ${otherName}`;
-            description = safeReasoning;
-            descriptionIsReasoning = true;
-            break;
-    }
-    if (!descriptionIsReasoning) {
-        description += `\n\n${safeReasoning}`;
-    }
-    if (format === 'notification') {
-        description =
-            description.length > 100 ? description.slice(0, 97) + '...' : description;
-    }
-    return {
-        title,
-        description,
-        callToAction: 'View Opportunity',
-    };
-}
-/**
- * Strips UUID patterns from user-facing text to prevent internal ID leaks.
- */
-const UUID_PATTERN = /[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi;
-export function stripUuids(text) {
-    return text
-        .replace(/\(([^)]*)\)/g, (_match, inner) => {
-        if (!UUID_PATTERN.test(inner)) {
-            UUID_PATTERN.lastIndex = 0;
-            return _match;
-        }
-        UUID_PATTERN.lastIndex = 0;
-        const cleaned = inner
-            .replace(UUID_PATTERN, '')
-            .replace(/,\s*,/g, ',')
-            .replace(/\b(?:from|and)\b/gi, '')
-            .replace(/^[\s,]+|[\s,]+$/g, '');
-        return cleaned ? `(${cleaned})` : '';
-    })
-        .replace(UUID_PATTERN, '')
-        .replace(/\s{2,}/g, ' ')
-        .trim();
-}
-/**
- * Truncate user-facing text to at most `maxChars` without cutting mid-word.
- *
- * Prefers a sentence boundary, then a word boundary, and only falls back to a
- * hard slice if no boundary exists within the limit. An ellipsis is appended
- * when the text is actually shortened. Used by presenter fallbacks so a degraded
- * card never shows a sentence chopped mid-word (e.g. "His focus on 'indiv").
- */
-export function truncateAtBoundary(text, maxChars) {
-    const trimmed = text.trim();
-    if (trimmed.length <= maxChars)
-        return trimmed;
-    const slice = trimmed.slice(0, maxChars);
-    // Prefer ending on the last completed sentence within the limit.
-    const lastSentence = Math.max(slice.lastIndexOf(". "), slice.lastIndexOf("! "), slice.lastIndexOf("? "));
-    if (lastSentence >= maxChars * 0.5) {
-        return slice.slice(0, lastSentence + 1).trim();
-    }
-    // Otherwise back off to the last whole word and add an ellipsis.
-    const lastSpace = slice.lastIndexOf(" ");
-    const body = lastSpace > 0 ? slice.slice(0, lastSpace) : slice;
-    return body.replace(/[\s,;:.!?'"-]+$/, "").trim() + "\u2026";
-}
-// Helper function
-function escapeRegex(s) {
-    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-/**
- * Viewer-centric text for opportunity cards.
- * The card is shown to the viewer (logged-in user) and should introduce the
- * counterpart, not describe the viewer to themselves.
- */
-/**
- * Splits text into sentences using (?<=[.!?])\s+ (period/exclamation/question followed by whitespace).
- * Note: splits after any such punctuation, including abbreviations like "Dr." or "e.g.".
- */
-function splitSentences(text) {
-    const trimmed = text.trim();
-    if (!trimmed)
-        return [];
-    return trimmed
-        .split(/(?<=[.!?])\s+/)
-        .map((s) => s.trim())
-        .filter(Boolean);
-}
-/**
- * Returns viewer-centric main text for an opportunity card.
- * Prefers the part of the reasoning that describes the counterpart (the person
- * on the card), so the viewer sees an introduction to the counterpart rather
- * than a description of themselves.
- *
- * @param reasoning - Raw interpretation.reasoning (may describe both parties).
- * @param counterpartName - Display name of the suggested connection (e.g. "Alex Chen").
- * @param maxChars - Max length of returned string (default MINIMAL_MAIN_TEXT_MAX_CHARS).
- * @param viewerName - Optional display name of the viewer (signed-in user). When provided, sentences or prefixes describing the viewer are skipped so the card introduces the counterpart, not the viewer.
- * @returns Viewer-centric snippet mentioning the counterpart when possible; if counterpartName is empty, returns reasoning truncated to maxChars. Never null; may be "A suggested connection." when reasoning is empty.
- */
-export function viewerCentricCardSummary(reasoning, counterpartName, maxChars = MINIMAL_MAIN_TEXT_MAX_CHARS, viewerName) {
-    const raw = stripUnsupportedOpportunityClaims(stripUuids(reasoning));
-    if (!raw)
-        return "A suggested connection.";
-    const name = counterpartName.trim();
-    if (!name) {
-        let out = raw.length <= maxChars ? raw : raw.slice(0, maxChars) + "...";
-        out = replaceViewerNameWithYou(out, viewerName);
-        return out;
-    }
-    const sentences = splitSentences(raw);
-    const nameLower = name.toLowerCase();
-    const firstWordOfName = name.split(/\s+/)[0]?.toLowerCase();
-    const hasCounterpartName = (s) => s.toLowerCase().includes(nameLower) ||
-        (firstWordOfName && firstWordOfName.length > 1 && s.toLowerCase().includes(firstWordOfName));
-    const viewer = viewerName?.trim().toLowerCase();
-    const viewerFirstWord = viewerName?.trim().split(/\s+/)[0]?.toLowerCase();
-    const startsWithViewer = (s) => {
-        if (!viewer)
-            return false;
-        const sl = s.toLowerCase();
-        return sl.startsWith(viewer) ||
-            (viewerFirstWord && viewerFirstWord.length > 1 && sl.startsWith(viewerFirstWord));
-    };
-    // When viewerName is provided, prefer sentences that mention the counterpart
-    // but do NOT start with the viewer's name.
-    if (viewer) {
-        // First pass: find a sentence that mentions counterpart and doesn't start with viewer
-        const cleanIdx = sentences.findIndex((s) => hasCounterpartName(s) && !startsWithViewer(s));
-        if (cleanIdx !== -1) {
-            const result = sentences.slice(cleanIdx).join(" ").trim();
-            let out = result.length <= maxChars ? result : result.slice(0, maxChars) + "...";
-            out = replaceViewerNameWithYou(out, viewerName, [name]);
-            return out;
-        }
-        // Second pass: sentence mentions counterpart but starts with viewer (compound sentence).
-        // Try to extract the counterpart portion after the counterpart's name.
-        const compoundIdx = sentences.findIndex((s) => hasCounterpartName(s) && startsWithViewer(s));
-        if (compoundIdx !== -1) {
-            const sentence = sentences[compoundIdx];
-            // Find where the counterpart name appears and extract from there
-            // Use case-insensitive Unicode-aware regex so the index is correct
-            // even when toLowerCase() changes string length (e.g. Turkish İ→i, German ß→ss).
-            const cpMatch = sentence.match(new RegExp(escapeRegex(name), "iu"));
-            const cpIdx = cpMatch?.index ?? -1;
-            if (cpIdx > 0) {
-                const extracted = sentence.slice(cpIdx).trim();
-                const rest = sentences.slice(compoundIdx + 1).join(" ").trim();
-                const result = rest ? `${extracted} ${rest}` : extracted;
-                let out = result.length <= maxChars ? result : result.slice(0, maxChars) + "...";
-                out = replaceViewerNameWithYou(out, viewerName, [name]);
-                return out;
-            }
-        }
-    }
-    // Fallback: original logic without viewer awareness
-    const idx = sentences.findIndex(hasCounterpartName);
-    if (idx === -1) {
-        let out = raw.length <= maxChars ? raw : raw.slice(0, maxChars) + "...";
-        out = replaceViewerNameWithYou(out, viewerName, [name]);
-        return out;
-    }
-    const fromCounterpart = sentences.slice(idx).join(" ").trim();
-    let out = fromCounterpart.length <= maxChars
-        ? fromCounterpart
-        : fromCounterpart.slice(0, maxChars) + "...";
-    out = replaceViewerNameWithYou(out, viewerName, [name]);
-    return out;
-}
-/** Max length for narrator chip text (matches LLM presenter schema). */
-const NARRATOR_MAX_CHARS = 80;
-const FALLBACK_REMARK = "A potential connection worth exploring.";
-/**
- * Generates a short narrator remark from opportunity reasoning for the narrator chip.
- * Used by the minimal (no-LLM) card path so each card gets a unique remark
- * instead of the same static text.
- *
- * Extracts domain keywords (e.g. "AI", "design", "machine learning") from the
- * reasoning and frames them in a short template like "Shared interest in AI and design."
- *
- * This is a regex-based heuristic — an alternative is OpportunityPresenter.presentCard()
- * which generates narratorRemark via LLM with much higher quality.
- *
- * @param reasoning - Raw interpretation.reasoning text.
- * @param counterpartName - Display name of the counterpart (stripped from output).
- * @param viewerName - Optional display name of the viewer (stripped from output).
- * @returns A short remark (max ~80 chars) suitable for the narrator chip. Never truncated with "...".
- */
-export function narratorRemarkFromReasoning(reasoning, counterpartName, viewerName) {
-    const raw = stripUnsupportedOpportunityClaims(stripUuids(reasoning)).trim();
-    if (!raw)
-        return FALLBACK_REMARK;
-    // Strip all person names from the text so we work only with topics.
-    let cleaned = raw;
-    for (const name of [counterpartName, viewerName]) {
-        if (!name?.trim())
-            continue;
-        const full = name.trim();
-        cleaned = cleaned.replace(new RegExp(escapeRegex(full), "gi"), "").trim();
-        const first = full.split(/\s+/)[0];
-        if (first && first.length > 1) {
-            cleaned = cleaned.replace(new RegExp(`\\b${escapeRegex(first)}\\b`, "gi"), "").trim();
-        }
-    }
-    // Extract domain/topic noun phrases from the cleaned text.
-    // Match multi-word capitalized phrases (e.g. "AI operations toolkit") and
-    // known domain terms.
-    const domainTerms = extractDomainTerms(cleaned);
-    if (domainTerms.length > 0) {
-        // Build "Shared interest in X and Y." or "Overlap in X, Y, and Z."
-        const prefixes = [
-            "Shared interest in",
-            "Overlap in",
-            "Common ground in",
-            "Aligned on",
-            "Mutual interest in",
-        ];
-        // Pick prefix deterministically based on first term's char code
-        const prefixIdx = domainTerms[0].charCodeAt(0) % prefixes.length;
-        const prefix = prefixes[prefixIdx];
-        const joined = joinTerms(domainTerms, NARRATOR_MAX_CHARS - prefix.length - 2); // -2 for " " and "."
-        const remark = `${prefix} ${joined}.`;
-        if (remark.length <= NARRATOR_MAX_CHARS)
-            return remark;
-    }
-    // Fallback: try to extract a short relationship phrase
-    const relationshipMatch = cleaned.match(/\b(complementary skills|shared expertise|overlapping intents|similar interests|strong match|mutual fit|potential collaboration|looking for (?:a |an )?[\w\s]{3,20})\b/i);
-    if (relationshipMatch) {
-        const phrase = relationshipMatch[0];
-        const remark = `Spotted ${phrase.toLowerCase()}.`;
-        if (remark.length <= NARRATOR_MAX_CHARS)
-            return remark;
-    }
-    return FALLBACK_REMARK;
-}
-/**
- * Extracts domain/topic terms from text by matching known patterns:
- * - Acronyms (AI, ML, UX, API)
- * - Multi-word domain phrases (machine learning, game development)
- * - Capitalized proper nouns that look like topics
- */
-function extractDomainTerms(text) {
-    const seen = new Set();
-    const terms = [];
-    // Known domain phrases (order matters — longer first)
-    const knownPhrases = [
-        /\b(machine learning|artificial intelligence|software development|game development|web development|data science|deep learning|natural language processing|computer vision|cloud computing|mobile development|product design|user experience|graphic design|character design|frontend development|backend development|full[- ]stack|smart contracts|visual art|creative writing|content creation|digital marketing|venture capital|angel invest(?:ing|ment)|open source|blockchain|cryptocurrency|decentralized finance|social impact|community building|music production|film(?:making| production)|photography|illustration|animation|3D modeling|startup|co-?founding|entrepreneurship|research|consulting|mentoring|freelanc(?:e|ing))\b/gi,
-        /\b(AI|ML|UX|UI|API|NLP|SaaS|DeFi|DevOps|DeSci|NFT|DAO|React|Node|Python|TypeScript|JavaScript|Rust|Solidity|Go|Swift|Kotlin|Figma|Blender|Unity|Unreal)\b/g,
-    ];
-    for (const pattern of knownPhrases) {
-        for (const match of text.matchAll(pattern)) {
-            const term = match[1] ?? match[0];
-            const key = term.toLowerCase();
-            if (!seen.has(key)) {
-                seen.add(key);
-                // Preserve case for short acronyms/proper nouns; lowercase multi-word phrases
-                if (term.length <= 5 && /^[A-Z]/.test(term)) {
-                    terms.push(term); // Keep React, AI, ML, etc. as-is
-                }
-                else {
-                    terms.push(key);
-                }
-            }
-        }
-    }
-    // If no known phrases found, look for capitalized multi-word phrases
-    // that look like explicit topic references (e.g. "Visual Art", "Smart Contracts").
-    // Only accept capitalized words to avoid grabbing meta-language from evaluator reasoning
-    // (e.g. "discoverer", "explicitly", "states" which are about the matching process, not topics).
-    if (terms.length === 0) {
-        // Multi-word capitalized phrases first (e.g. "Visual Art", "Creative Writing")
-        const multiWordPattern = /\b([A-Z][a-z]+(?:\s+[A-Z][a-z]+)+)\b/g;
-        for (const match of text.matchAll(multiWordPattern)) {
-            const term = match[1];
-            const key = term.toLowerCase();
-            if (!seen.has(key)) {
-                seen.add(key);
-                terms.push(key);
-                if (terms.length >= 3)
-                    break;
-            }
-        }
-        // Single capitalized words as last resort (skip common sentence-starters and meta-words)
-        if (terms.length === 0) {
-            const skipCapitalized = new Set([
-                // Articles / conjunctions / prepositions (capitalized at sentence start)
-                "the", "and", "but", "for", "from", "with", "without", "between",
-                "into", "about", "after", "before", "over", "under", "through",
-                // Common sentence starters / pronouns / determiners
-                "both", "their", "they", "this", "that", "these", "those",
-                "here", "there", "would", "could", "should", "also", "very",
-                "one", "another", "other", "each", "some", "many", "most",
-                "such", "clear", "high", "good", "well", "just", "even",
-                // Generic matching/relationship language
-                "strong", "match", "based", "making", "looking", "seeking",
-                "connection", "relationship", "opportunity", "overlap",
-                "complementary", "potential", "interested", "collaborate",
-                // Evaluator meta-language (about the matching process, not topics)
-                "intent", "intents", "profile", "user", "users", "person",
-                "discoverer", "explicitly", "states", "expressed", "mentioned",
-                "indicates", "suggests", "demonstrates", "describes", "involves",
-                "inference", "preparatory", "sincerity", "evaluator", "classifier",
-                "semantic", "pragmatic", "verification", "reconciliation",
-                "assertive", "commissive", "directive", "illocutionary",
-                "felicity", "utterance", "detected", "analysis", "confirmed",
-                "genuine", "conditions", "determined",
-                // Discourse markers
-                "particularly", "specifically", "especially", "primarily",
-                "overall", "furthermore", "however", "therefore", "moreover",
-            ]);
-            const capWords = text.match(/\b[A-Z][a-z]{2,}\b/g) ?? [];
-            for (const w of capWords) {
-                const key = w.toLowerCase();
-                if (!skipCapitalized.has(key) && !seen.has(key)) {
-                    seen.add(key);
-                    terms.push(key);
-                    if (terms.length >= 3)
-                        break;
-                }
-            }
-        }
-    }
-    return terms.slice(0, 3); // Max 3 terms
-}
-/** Joins terms into "X, Y, and Z" form, dropping terms if too long. */
-function joinTerms(terms, maxLen) {
-    if (terms.length === 1)
-        return terms[0];
-    // Try all terms first
-    for (let count = terms.length; count >= 1; count--) {
-        const subset = terms.slice(0, count);
-        let joined;
-        if (subset.length === 1) {
-            joined = subset[0];
-        }
-        else if (subset.length === 2) {
-            joined = `${subset[0]} and ${subset[1]}`;
-        }
-        else {
-            joined = `${subset.slice(0, -1).join(", ")}, and ${subset[subset.length - 1]}`;
-        }
-        if (joined.length <= maxLen)
-            return joined;
-    }
-    return terms[0].slice(0, maxLen);
-}
-/**
- * Replaces viewer's name with "you"/"your" so the card addresses the viewer in second person.
- * Applied to mainText when viewerName is provided.
- * @param otherNames - Other actor names in the card; first-name replacement is
- *   skipped when the viewer's first name matches any other actor's first name.
- */
-function replaceViewerNameWithYou(text, viewerName, otherNames) {
-    if (!viewerName?.trim())
-        return text;
-    const full = viewerName.trim();
-    const first = full.split(/\s+/)[0];
-    let out = text;
-    // Possessive: "Yankı's" → "your", "Yankı Ekin Yüksel's" → "your"
-    out = out.replace(new RegExp(`\\b${escapeRegex(full)}'s\\b`, "gi"), "your");
-    const otherFirstNames = (otherNames ?? [])
-        .map(n => n.trim().split(/\s+/)[0]?.toLowerCase())
-        .filter(Boolean);
-    const firstNameCollides = first && otherFirstNames.includes(first.toLowerCase());
-    if (first && first.length > 1 && !firstNameCollides) {
-        out = out.replace(new RegExp(`\\b${escapeRegex(first)}'s\\b`, "gi"), "your");
-    }
-    // Standalone: full name then first name so we don't break "Yankı Ekin Yüksel"
-    out = out.replace(new RegExp(`\\b${escapeRegex(full)}\\b`, "gi"), "you");
-    if (first && first.length > 1 && !firstNameCollides) {
-        out = out.replace(new RegExp(`\\b${escapeRegex(first)}\\b`, "gi"), "you");
-    }
-    return out;
-}
 // ──────────────────────────────────────────────────────────────────────
-// ── 2. Presentation cache keys ──
+// ── 1. Presentation cache keys ──
 // ──────────────────────────────────────────────────────────────────────
 /** Cache namespace for opportunity presentation copy. Bump to invalidate copy safety changes. */
 export const OPPORTUNITY_PRESENTATION_CACHE_VERSION = "v2";
-export function buildRadarCardPresentationCacheKey(opportunityId, status, viewerId, focusedViewerIntentId) {
+export function buildOpportunityCardCacheKey(opportunityId, status, viewerId, focusedViewerIntentId) {
     const scope = focusedViewerIntentId ? `:intent:${focusedViewerIntentId}` : "";
-    return `radar:${OPPORTUNITY_PRESENTATION_CACHE_VERSION}:card:${opportunityId}:${status}:${viewerId}${scope}`;
+    return `card:${OPPORTUNITY_PRESENTATION_CACHE_VERSION}:${opportunityId}:${status}:${viewerId}${scope}`;
 }
 export function buildApiChatCardPresentationCacheKey(opportunityId, viewerId) {
     return `chat:${OPPORTUNITY_PRESENTATION_CACHE_VERSION}:card:${opportunityId}:${viewerId}`;
 }
-// ──────────────────────────────────────────────────────────────────────
-// ── 3. Safe-presentation pipeline ──
-// ──────────────────────────────────────────────────────────────────────
-/**
- * Shared safe-presentation primitive for all user-facing opportunity surfaces.
- *
- * Historically every surface (radar, list/discover cards, minimal chat
- * cards, notification emails/Telegram, chat context, delivery cards) invented
- * its own fallback chain for the case where genuine LLM presenter output is
- * unavailable — some sliced raw `interpretation.reasoning` with no
- * sanitization at all. This module is the single standard:
- *
- *   raw reasoning
- *     → whitespace-normalize
- *     → viewer-centric rewrite (incl. UUID stripping)
- *     → boundary-aware truncation
- *     → per-surface empty-text default
- *
- * Surfaces choose *policy* (send a sanitized fallback vs skip entirely) via
- * `allowFallback`; they no longer choose (or forget) sanitization steps.
- *
- * See `packages/protocol/s./opportunity/AGENTS.md` for the review checklist this
- * module exists to satisfy.
- */
-/** Default max length for fallback summaries (matches presenter internal fallback). */
-export const SAFE_FALLBACK_MAX_CHARS = 300;
-/** Default copy when no reasoning text is available at all. */
-export const DEFAULT_EMPTY_FALLBACK_TEXT = "A promising connection.";
-/** Default headline for fallback presentations (matches presenter internal fallback). */
-export const DEFAULT_FALLBACK_HEADLINE = "A promising connection";
-/** Default CTA for fallback presentations (matches presenter internal fallback). */
-export const DEFAULT_FALLBACK_ACTION = "Take a look and decide whether to reach out.";
-/**
- * Produce safe user-facing fallback copy from raw match reasoning.
- *
- * This is the ONE sanitization standard: UUID stripping,
- * stripping, and viewer-centric rewrite (via {@link viewerCentricCardSummary}),
- * followed by whitespace normalization and boundary-aware truncation (via
- * {@link truncateAtBoundary}). Never returns raw reasoning verbatim beyond
- * these guarantees, and never returns an empty string.
- *
- * @param rawReasoning - Raw `interpretation.reasoning` / `matchReason` text (may be null/undefined).
- * @param opts - Per-surface knobs (names for rewrite, max length, empty-text copy).
- */
-export function safeFallbackSummary(rawReasoning, opts = {}) {
-    const emptyText = opts.emptyText ?? DEFAULT_EMPTY_FALLBACK_TEXT;
-    const maxChars = opts.maxChars ?? SAFE_FALLBACK_MAX_CHARS;
-    const normalized = (rawReasoning ?? "").replace(/\s+/g, " ").trim();
-    if (!normalized)
-        return emptyText;
-    const claimSafeInput = stripUnsupportedOpportunityClaims(normalized);
-    if (!claimSafeInput)
-        return emptyText;
-    // viewerCentricCardSummary handles UUID stripping,
-    // stripping, and the viewer-centric rewrite. Pass Infinity so truncation is
-    // handled by boundary-aware logic below instead of a mid-word hard slice.
-    const rewritten = viewerCentricCardSummary(claimSafeInput, opts.counterpartName ?? "", Number.POSITIVE_INFINITY, opts.viewerName);
-    // Claim validation intentionally runs after viewer-centric rewriting: rewrite
-    // heuristics may select or join different source sentences, and the final
-    // user-facing sentence set is what must be safe.
-    const claimSafe = stripUnsupportedOpportunityClaims(rewritten);
-    const truncated = truncateAtBoundary(claimSafe, maxChars);
-    return truncated || emptyText;
-}
-/**
- * Resolve the safe user-facing presentation for an opportunity, or signal skip.
- *
- * Resolution order:
- * 1. Genuine presenter output (`homeCardPresentation` present, non-empty, and
- *    NOT tagged `isFallback` by the presenter) — claim-validated before return.
- * 2. Otherwise, if `allowFallback` (default true): sanitized fallback copy
- *    built from `matchReason` / `interpretation.reasoning` via
- *    {@link safeFallbackSummary}.
- * 3. Otherwise `null` — the surface must skip this opportunity.
- *
- * Raw `interpretation.reasoning` / `matchReason` never reaches the caller
- * unsanitized through this function.
- */
-export function getSafePresentationOrSkip(source, opts = {}) {
-    const candidate = source.homeCardPresentation;
-    if (candidate?.personalizedSummary?.trim() && !candidate.isFallback) {
-        const summary = stripUnsupportedOpportunityClaims(candidate.personalizedSummary);
-        if (summary) {
-            return {
-                headline: stripUnsupportedOpportunityClaims(candidate.headline) ||
-                    DEFAULT_FALLBACK_HEADLINE,
-                summary,
-                suggestedAction: stripUnsupportedOpportunityClaims(candidate.suggestedAction) ||
-                    DEFAULT_FALLBACK_ACTION,
-                isFallback: false,
-            };
-        }
-    }
-    if (opts.allowFallback === false)
-        return null;
-    const rawReasoning = source.matchReason ?? source.interpretation?.reasoning ?? "";
-    return {
-        headline: DEFAULT_FALLBACK_HEADLINE,
-        summary: safeFallbackSummary(rawReasoning, opts),
-        suggestedAction: DEFAULT_FALLBACK_ACTION,
-        isFallback: true,
-    };
-}
-const presentLog = protocolLogger("OpportunityPresenter:present");
-const presentCardLog = protocolLogger("OpportunityPresenter:presentCard");
 const LLM_TIMEOUT_MS = 20000;
 const GREETING_DESCRIPTION = "A 2-4 sentence first-person message the viewer could send to the counterpart, in the viewer's voice, referencing what they have in common. Plain prose only — no markdown, no greeting prefix like 'Hey {Name},'. Example body: 'Saw we're both working on regenerative coordination tooling — your post on consent flows resonated. Would love to compare notes if you have time this week.'";
 // ──────────────────────────────────────────────────────────────
@@ -622,6 +92,8 @@ Rules:
 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.
 7. Network assignment, network title/type, and network/event metadata are retrieval context only. They are NEVER proof that a person attended or will attend, belongs to a group, resides in a place, knows anyone from the network, or shared a session, time, place, or location with anyone. Do not make co-attendance, membership, residence, shared-session, or same-place/same-time claims from network co-membership.
+8. Match reasoning may describe the viewer in third person; always write from the viewer's perspective.
+9. Never output internal IDs.
 
 
 **Role-Specific Presentation:**
@@ -667,6 +139,8 @@ Rules:
 - 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.
 - Network assignment, network title/type, and network/event metadata are retrieval context only. They are NEVER proof that a person attended or will attend, belongs to a group, resides in a place, knows anyone from the network, or shared a session, time, place, or location with anyone. Do not make co-attendance, membership, residence, shared-session, or same-place/same-time claims from network co-membership.
+- Match reasoning may describe the viewer in third person; always write from the viewer's perspective.
+- Never output internal IDs.
 - If you cannot fit every detail, choose one clear reason and stop. Do not rely on downstream truncation.
 
 **Negotiation-grounded explanations (ONLY when NEGOTIATION CONTEXT is provided):**
@@ -678,16 +152,6 @@ When NEGOTIATION CONTEXT is provided, this opportunity passed through an agent-t
 
 `;
 // ──────────────────────────────────────────────────────────────
-// DETERMINISTIC OUTPUT VALIDATION
-// ──────────────────────────────────────────────────────────────
-function sanitizePresenterField(value, fallback, allowEmpty = fallback === "") {
-    const cleaned = stripUnsupportedOpportunityClaims(stripUuids(value));
-    if (cleaned || allowEmpty) {
-        return { value: cleaned, usedFallback: false };
-    }
-    return { value: fallback, usedFallback: true };
-}
-// ──────────────────────────────────────────────────────────────
 // CLASS
 // ──────────────────────────────────────────────────────────────
 export class OpportunityPresenter {
@@ -722,6 +186,11 @@ export class OpportunityPresenter {
     }
     /**
      * Generate personalized presentation for a single opportunity.
+     *
+     * @param input - Pre-assembled presenter context.
+     * @param options - Optional abort signal.
+     * @returns The LLM-generated presentation.
+     * @throws When the LLM call fails, times out, or returns invalid output.
      */
     async present(input, options = {}) {
         const humanContent = `
@@ -741,47 +210,12 @@ Viewer's role in this opportunity: ${input.viewerRole}
 
 Produce headline, personalizedSummary (2-3 sentences in "you" language), suggestedAction, and greeting.
 `;
-        try {
-            const messages = [
-                new SystemMessage(systemPrompt),
-                new HumanMessage(humanContent),
-            ];
-            const result = await this.invokeWithTimeout(this.model, messages, options.signal);
-            const parsed = responseFormat.parse(result);
-            const headline = sanitizePresenterField(parsed.presentation.headline, DEFAULT_FALLBACK_HEADLINE);
-            const summary = sanitizePresenterField(parsed.presentation.personalizedSummary, DEFAULT_EMPTY_FALLBACK_TEXT);
-            const action = sanitizePresenterField(parsed.presentation.suggestedAction, DEFAULT_FALLBACK_ACTION);
-            const greeting = sanitizePresenterField(parsed.presentation.greeting, "");
-            const usedFallback = headline.usedFallback || summary.usedFallback || action.usedFallback || greeting.usedFallback;
-            return {
-                headline: headline.value,
-                personalizedSummary: summary.value,
-                suggestedAction: action.value,
-                greeting: greeting.value,
-                ...(usedFallback ? { isFallback: true, fallbackReason: "sanitization" } : {}),
-            };
-        }
-        catch (e) {
-            if (options.signal?.aborted)
-                throw e;
-            const message = e instanceof Error ? e.message : String(e);
-            const timeoutReason = message.includes("timed out") ? message : undefined;
-            presentLog.warn("LLM failed, returning fallback", {
-                event: "presenter_fallback",
-                presenter: "opportunity",
-                reason: timeoutReason ? "timeout" : "parse_error",
-                message,
-                timeoutReason,
-            });
-            return {
-                headline: DEFAULT_FALLBACK_HEADLINE,
-                personalizedSummary: safeFallbackSummary(input.matchReasoning),
-                suggestedAction: DEFAULT_FALLBACK_ACTION,
-                greeting: "",
-                isFallback: true,
-                fallbackReason: timeoutReason ? "timeout" : "error",
-            };
-        }
+        const messages = [
+            new SystemMessage(systemPrompt),
+            new HumanMessage(humanContent),
+        ];
+        const result = await this.invokeWithTimeout(this.model, messages, options.signal);
+        return responseFormat.parse(result).presentation;
     }
     /**
      * Generate LLM-powered card content (headline, body, narrator remark, mutual-intent label).
@@ -790,6 +224,10 @@ Produce headline, personalizedSummary (2-3 sentences in "you" language), suggest
      * When `negotiationContext.status === 'negotiating'`, returns a templated
      * chip synchronously without invoking the LLM — the card just reflects
      * "negotiation in progress" at that point.
+     *
+     * @param input - Pre-assembled card presenter context.
+     * @returns The LLM-generated card copy.
+     * @throws When the LLM call fails, times out, or returns invalid output.
      */
     async presentCard(input) {
         if (input.negotiationContext?.status === 'negotiating') {
@@ -825,58 +263,12 @@ Opportunity status: ${input.opportunityStatus ?? "pending"}
 
 Produce headline, personalizedSummary, suggestedAction, narratorRemark, greeting, and mutualIntentsLabel.
 `;
-        try {
-            const messages = [
-                new SystemMessage(homeCardSystemPrompt),
-                new HumanMessage(humanContent),
-            ];
-            const result = await this.invokeWithTimeout(this.homeCardModel, messages);
-            const parsed = homeCardResponseFormat.parse(result);
-            if (/^0\s+(mutual|overlapping)\s+intent/i.test(parsed.presentation.mutualIntentsLabel)) {
-                parsed.presentation.mutualIntentsLabel = "Shared interests";
-            }
-            const fields = {
-                headline: sanitizePresenterField(parsed.presentation.headline, DEFAULT_FALLBACK_HEADLINE),
-                personalizedSummary: sanitizePresenterField(parsed.presentation.personalizedSummary, DEFAULT_EMPTY_FALLBACK_TEXT),
-                suggestedAction: sanitizePresenterField(parsed.presentation.suggestedAction, DEFAULT_FALLBACK_ACTION),
-                narratorRemark: sanitizePresenterField(parsed.presentation.narratorRemark, "Worth a look."),
-                mutualIntentsLabel: sanitizePresenterField(parsed.presentation.mutualIntentsLabel, "Shared interests"),
-                greeting: sanitizePresenterField(parsed.presentation.greeting, ""),
-            };
-            const usedFallback = Object.values(fields).some((field) => field.usedFallback);
-            return {
-                headline: fields.headline.value,
-                personalizedSummary: fields.personalizedSummary.value,
-                suggestedAction: fields.suggestedAction.value,
-                narratorRemark: fields.narratorRemark.value,
-                mutualIntentsLabel: fields.mutualIntentsLabel.value,
-                greeting: fields.greeting.value,
-                ...(usedFallback ? { isFallback: true } : {}),
-            };
-        }
-        catch (e) {
-            const message = e instanceof Error ? e.message : String(e);
-            const timeoutReason = message.includes("timed out") ? message : undefined;
-            presentCardLog.warn("LLM failed, returning fallback", {
-                event: "presenter_fallback",
-                presenter: "home_card",
-                reason: timeoutReason ? "timeout" : "parse_error",
-                message,
-                timeoutReason,
-            });
-            const fallbackSummary = safeFallbackSummary(input.matchReasoning);
-            return {
-                headline: "A promising connection",
-                personalizedSummary: fallbackSummary,
-                suggestedAction: "Take a look and decide whether to reach out.",
-                narratorRemark: "Worth a look.",
-                mutualIntentsLabel: input.mutualIntentCount != null && input.mutualIntentCount > 0
-                    ? `${input.mutualIntentCount} mutual intent${input.mutualIntentCount !== 1 ? "s" : ""}`
-                    : "Shared interests",
-                greeting: "",
-                isFallback: true,
-            };
-        }
+        const messages = [
+            new SystemMessage(homeCardSystemPrompt),
+            new HumanMessage(humanContent),
+        ];
+        const result = await this.invokeWithTimeout(this.homeCardModel, messages);
+        return homeCardResponseFormat.parse(result).presentation;
     }
     /**
      * Process multiple opportunities in parallel with bounded concurrency.
@@ -995,7 +387,7 @@ export function summarizeSignalsForPresenter(signals) {
  * Gather all context needed for the presenter from the database.
  * Fetches viewer profile, viewer intents, other party profile(s), and network in parallel.
  *
- * @param displayCounterpartUserId - When set (e.g. for a radar card), only this counterpart is included in otherPartyContext so the presenter writes about the person on the card.
+ * @param displayCounterpartUserId - When set (e.g. for an opportunity card), only this counterpart is included in otherPartyContext so the presenter writes about the person on the card.
  * @param focusedViewerIntentId - When set, include only that active intent in viewer context.
  */
 export async function gatherPresenterContext(database, opportunity, viewerId, displayCounterpartUserId, focusedViewerIntentId) {
@@ -1045,23 +437,15 @@ export async function gatherPresenterContext(database, opportunity, viewerId, di
             otherParts.join("\n\n") || "Other party (details not available).";
     }
     const interp = opportunity.interpretation;
-    const signalsSummary = summarizeSignalsForPresenter(interp.signals);
-    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)
-        : stripUuids(interp.reasoning);
     const result = {
         viewerContext,
         otherPartyContext,
-        matchReasoning,
+        matchReasoning: interp.reasoning,
         category: interp.category ?? "connection",
         confidence: typeof interp.confidence === "number"
             ? interp.confidence
             : parseFloat(String(interp.confidence ?? 0)) || 0,
-        signalsSummary,
+        signalsSummary: summarizeSignalsForPresenter(interp.signals),
         networkName: networkRecord?.title ?? contextNetworkId ?? "",
         viewerRole: myActor.role ?? "party",
     };