@indexnetwork/protocol 14.3.2-rc.477.1 → 16.1.1-rc.478.1

package/dist/opportunities/domain/opportunity.safe-presentation.js

@@ -1,102 +0,0 @@
-/**
- * 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 + introducer-mention 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/src/opportunity/AGENTS.md` for the review checklist this
- * module exists to satisfy.
- */
-import { truncateAtBoundary, viewerCentricCardSummary } from "./opportunity.presentation.js";
-import { stripUnsupportedOpportunityClaims } from "../../shared/utils/claim-safety.js";
-/** 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, introducer-mention
- * 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, introducer-mention
-    // 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, opts.introducerName ?? undefined);
-    // 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,
-    };
-}