@indexnetwork/protocol 6.10.0-rc.397.1 → 6.10.0-rc.398.1

package/dist/opportunity/opportunity.safe-presentation.d.ts

@@ -16,7 +16,7 @@
  * Surfaces choose *policy* (send a sanitized fallback vs skip entirely) via
  * `allowFallback`; they no longer choose (or forget) sanitization steps.
  *
- * See `.pi/skills/review-opportunity-presentation/SKILL.md` for the review
+ * See `.agents/skills/review-opportunity-presentation/SKILL.md` for the review
  * checklist this module exists to satisfy.
  */
 /** Default max length for fallback summaries (matches presenter internal fallback). */

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

@@ -16,7 +16,7 @@
  * Surfaces choose *policy* (send a sanitized fallback vs skip entirely) via
  * `allowFallback`; they no longer choose (or forget) sanitization steps.
  *
- * See `.pi/skills/review-opportunity-presentation/SKILL.md` for the review
+ * See `.agents/skills/review-opportunity-presentation/SKILL.md` for the review
  * checklist this module exists to satisfy.
  */
 import { truncateAtBoundary, viewerCentricCardSummary } from "./opportunity.presentation.js";

package/dist/opportunity/opportunity.safe-presentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"opportunity.safe-presentation.js","sourceRoot":"/","sources":["opportunity/opportunity.safe-presentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,iCAAiC,EAAE,MAAM,+BAA+B,CAAC;AAElF,uFAAuF;AACvF,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,+DAA+D;AAC/D,MAAM,CAAC,MAAM,2BAA2B,GAAG,yBAAyB,CAAC;AAErE,yFAAyF;AACzF,MAAM,CAAC,MAAM,yBAAyB,GAAG,wBAAwB,CAAC;AAElE,oFAAoF;AACpF,MAAM,CAAC,MAAM,uBAAuB,GAClC,8CAA8C,CAAC;AAejD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,YAAuC,EACvC,OAA4B,EAAE;IAE9B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,2BAA2B,CAAC;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,uBAAuB,CAAC;IAE1D,MAAM,UAAU,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACpE,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,MAAM,cAAc,GAAG,iCAAiC,CAAC,UAAU,CAAC,CAAC;IACrE,IAAI,CAAC,cAAc;QAAE,OAAO,SAAS,CAAC;IAEtC,sEAAsE;IACtE,4EAA4E;IAC5E,0EAA0E;IAC1E,MAAM,SAAS,GAAG,wBAAwB,CACxC,cAAc,EACd,IAAI,CAAC,eAAe,IAAI,EAAE,EAC1B,MAAM,CAAC,iBAAiB,EACxB,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,cAAc,IAAI,SAAS,CACjC,CAAC;IAEF,8EAA8E;IAC9E,0EAA0E;IAC1E,iDAAiD;IACjD,MAAM,SAAS,GAAG,iCAAiC,CAAC,SAAS,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,kBAAkB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC1D,OAAO,SAAS,IAAI,SAAS,CAAC;AAChC,CAAC;AAuCD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAA8B,EAC9B,OAAgC,EAAE;IAElC,MAAM,SAAS,GAAG,MAAM,CAAC,oBAAoB,CAAC;IAC9C,IAAI,SAAS,EAAE,mBAAmB,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QACpE,MAAM,OAAO,GAAG,iCAAiC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QACjF,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO;gBACL,QAAQ,EACN,iCAAiC,CAAC,SAAS,CAAC,QAAQ,CAAC;oBACrD,yBAAyB;gBAC3B,OAAO;gBACP,eAAe,EACb,iCAAiC,CAAC,SAAS,CAAC,eAAe,CAAC;oBAC5D,uBAAuB;gBACzB,UAAU,EAAE,KAAK;aAClB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,aAAa,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAE9C,MAAM,YAAY,GAChB,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,cAAc,EAAE,SAAS,IAAI,EAAE,CAAC;IAC/D,OAAO;QACL,QAAQ,EAAE,yBAAyB;QACnC,OAAO,EAAE,mBAAmB,CAAC,YAAY,EAAE,IAAI,CAAC;QAChD,eAAe,EAAE,uBAAuB;QACxC,UAAU,EAAE,IAAI;KACjB,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Shared safe-presentation primitive for all user-facing opportunity surfaces.\n *\n * Historically every surface (home feed, list/discover cards, minimal chat\n * cards, notification emails/Telegram, chat context, delivery cards) invented\n * its own fallback chain for the case where genuine LLM presenter output is\n * unavailable — some sliced raw `interpretation.reasoning` with no\n * sanitization at all. This module is the single standard:\n *\n *   raw reasoning\n *     → whitespace-normalize\n *     → viewer-centric rewrite (incl. UUID stripping + introducer-mention stripping)\n *     → boundary-aware truncation\n *     → per-surface empty-text default\n *\n * Surfaces choose *policy* (send a sanitized fallback vs skip entirely) via\n * `allowFallback`; they no longer choose (or forget) sanitization steps.\n *\n * See `.pi/skills/review-opportunity-presentation/SKILL.md` for the review\n * checklist this module exists to satisfy.\n */\n\nimport { truncateAtBoundary, viewerCentricCardSummary } from \"./opportunity.presentation.js\";\nimport { stripUnsupportedOpportunityClaims } from \"./opportunity.claim-safety.js\";\n\n/** Default max length for fallback summaries (matches presenter internal fallback). */\nexport const SAFE_FALLBACK_MAX_CHARS = 300;\n\n/** Default copy when no reasoning text is available at all. */\nexport const DEFAULT_EMPTY_FALLBACK_TEXT = \"A promising connection.\";\n\n/** Default headline for fallback presentations (matches presenter internal fallback). */\nexport const DEFAULT_FALLBACK_HEADLINE = \"A promising connection\";\n\n/** Default CTA for fallback presentations (matches presenter internal fallback). */\nexport const DEFAULT_FALLBACK_ACTION =\n  \"Take a look and decide whether to reach out.\";\n\nexport interface SafeFallbackOptions {\n  /** Display name of the counterpart shown on the card (enables viewer-centric rewrite). */\n  counterpartName?: string;\n  /** Display name of the viewer; sentences describing the viewer are skipped/rewritten to \"you\". */\n  viewerName?: string;\n  /** Introducer display name; introducer mentions are stripped from the summary body. */\n  introducerName?: string | null;\n  /** Max output length (boundary-aware). Default {@link SAFE_FALLBACK_MAX_CHARS}. */\n  maxChars?: number;\n  /** Copy returned when reasoning is empty/blank. Default {@link DEFAULT_EMPTY_FALLBACK_TEXT}. */\n  emptyText?: string;\n}\n\n/**\n * Produce safe user-facing fallback copy from raw match reasoning.\n *\n * This is the ONE sanitization standard: UUID stripping, introducer-mention\n * stripping, and viewer-centric rewrite (via {@link viewerCentricCardSummary}),\n * followed by whitespace normalization and boundary-aware truncation (via\n * {@link truncateAtBoundary}). Never returns raw reasoning verbatim beyond\n * these guarantees, and never returns an empty string.\n *\n * @param rawReasoning - Raw `interpretation.reasoning` / `matchReason` text (may be null/undefined).\n * @param opts - Per-surface knobs (names for rewrite, max length, empty-text copy).\n */\nexport function safeFallbackSummary(\n  rawReasoning: string | null | undefined,\n  opts: SafeFallbackOptions = {},\n): string {\n  const emptyText = opts.emptyText ?? DEFAULT_EMPTY_FALLBACK_TEXT;\n  const maxChars = opts.maxChars ?? SAFE_FALLBACK_MAX_CHARS;\n\n  const normalized = (rawReasoning ?? \"\").replace(/\\s+/g, \" \").trim();\n  if (!normalized) return emptyText;\n  const claimSafeInput = stripUnsupportedOpportunityClaims(normalized);\n  if (!claimSafeInput) return emptyText;\n\n  // viewerCentricCardSummary handles UUID stripping, introducer-mention\n  // stripping, and the viewer-centric rewrite. Pass Infinity so truncation is\n  // handled by boundary-aware logic below instead of a mid-word hard slice.\n  const rewritten = viewerCentricCardSummary(\n    claimSafeInput,\n    opts.counterpartName ?? \"\",\n    Number.POSITIVE_INFINITY,\n    opts.viewerName,\n    opts.introducerName ?? undefined,\n  );\n\n  // Claim validation intentionally runs after viewer-centric rewriting: rewrite\n  // heuristics may select or join different source sentences, and the final\n  // user-facing sentence set is what must be safe.\n  const claimSafe = stripUnsupportedOpportunityClaims(rewritten);\n  const truncated = truncateAtBoundary(claimSafe, maxChars);\n  return truncated || emptyText;\n}\n\n/** Minimal presenter-output shape the primitive inspects (subset of HomeCardPresentationResult). */\nexport interface SafePresentationCandidate {\n  headline?: string;\n  personalizedSummary?: string;\n  suggestedAction?: string;\n  /** Set by OpportunityPresenter when its LLM call failed and it returned fallback-shaped copy. */\n  isFallback?: boolean;\n}\n\n/** Opportunity-ish source object accepted by {@link getSafePresentationOrSkip}. */\nexport interface SafePresentationSource {\n  /** Presenter output attached to the record, when available. */\n  homeCardPresentation?: SafePresentationCandidate | null;\n  /** Pre-truncated raw reasoning carried on discovery/list card data. */\n  matchReason?: string | null;\n  /** Full opportunity interpretation, when the caller holds the record. */\n  interpretation?: { reasoning?: string | null } | null;\n}\n\nexport interface SafePresentationOptions extends SafeFallbackOptions {\n  /**\n   * Policy switch: when false, return null instead of fallback copy so the\n   * surface can skip rendering entirely (e.g. scheduled digests where sending\n   * degraded copy is worse than sending nothing). Default true.\n   */\n  allowFallback?: boolean;\n}\n\n/** Resolved safe presentation for a surface to render. */\nexport interface SafePresentation {\n  headline: string;\n  summary: string;\n  suggestedAction: string;\n  /** True when copy was derived from raw reasoning rather than genuine LLM presenter output. */\n  isFallback: boolean;\n}\n\n/**\n * Resolve the safe user-facing presentation for an opportunity, or signal skip.\n *\n * Resolution order:\n * 1. Genuine presenter output (`homeCardPresentation` present, non-empty, and\n *    NOT tagged `isFallback` by the presenter) — claim-validated before return.\n * 2. Otherwise, if `allowFallback` (default true): sanitized fallback copy\n *    built from `matchReason` / `interpretation.reasoning` via\n *    {@link safeFallbackSummary}.\n * 3. Otherwise `null` — the surface must skip this opportunity.\n *\n * Raw `interpretation.reasoning` / `matchReason` never reaches the caller\n * unsanitized through this function.\n */\nexport function getSafePresentationOrSkip(\n  source: SafePresentationSource,\n  opts: SafePresentationOptions = {},\n): SafePresentation | null {\n  const candidate = source.homeCardPresentation;\n  if (candidate?.personalizedSummary?.trim() && !candidate.isFallback) {\n    const summary = stripUnsupportedOpportunityClaims(candidate.personalizedSummary);\n    if (summary) {\n      return {\n        headline:\n          stripUnsupportedOpportunityClaims(candidate.headline) ||\n          DEFAULT_FALLBACK_HEADLINE,\n        summary,\n        suggestedAction:\n          stripUnsupportedOpportunityClaims(candidate.suggestedAction) ||\n          DEFAULT_FALLBACK_ACTION,\n        isFallback: false,\n      };\n    }\n  }\n\n  if (opts.allowFallback === false) return null;\n\n  const rawReasoning =\n    source.matchReason ?? source.interpretation?.reasoning ?? \"\";\n  return {\n    headline: DEFAULT_FALLBACK_HEADLINE,\n    summary: safeFallbackSummary(rawReasoning, opts),\n    suggestedAction: DEFAULT_FALLBACK_ACTION,\n    isFallback: true,\n  };\n}\n"]}
+{"version":3,"file":"opportunity.safe-presentation.js","sourceRoot":"/","sources":["opportunity/opportunity.safe-presentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,iCAAiC,EAAE,MAAM,+BAA+B,CAAC;AAElF,uFAAuF;AACvF,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,+DAA+D;AAC/D,MAAM,CAAC,MAAM,2BAA2B,GAAG,yBAAyB,CAAC;AAErE,yFAAyF;AACzF,MAAM,CAAC,MAAM,yBAAyB,GAAG,wBAAwB,CAAC;AAElE,oFAAoF;AACpF,MAAM,CAAC,MAAM,uBAAuB,GAClC,8CAA8C,CAAC;AAejD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,YAAuC,EACvC,OAA4B,EAAE;IAE9B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,2BAA2B,CAAC;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,uBAAuB,CAAC;IAE1D,MAAM,UAAU,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACpE,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,MAAM,cAAc,GAAG,iCAAiC,CAAC,UAAU,CAAC,CAAC;IACrE,IAAI,CAAC,cAAc;QAAE,OAAO,SAAS,CAAC;IAEtC,sEAAsE;IACtE,4EAA4E;IAC5E,0EAA0E;IAC1E,MAAM,SAAS,GAAG,wBAAwB,CACxC,cAAc,EACd,IAAI,CAAC,eAAe,IAAI,EAAE,EAC1B,MAAM,CAAC,iBAAiB,EACxB,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,cAAc,IAAI,SAAS,CACjC,CAAC;IAEF,8EAA8E;IAC9E,0EAA0E;IAC1E,iDAAiD;IACjD,MAAM,SAAS,GAAG,iCAAiC,CAAC,SAAS,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,kBAAkB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC1D,OAAO,SAAS,IAAI,SAAS,CAAC;AAChC,CAAC;AAuCD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAA8B,EAC9B,OAAgC,EAAE;IAElC,MAAM,SAAS,GAAG,MAAM,CAAC,oBAAoB,CAAC;IAC9C,IAAI,SAAS,EAAE,mBAAmB,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QACpE,MAAM,OAAO,GAAG,iCAAiC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QACjF,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO;gBACL,QAAQ,EACN,iCAAiC,CAAC,SAAS,CAAC,QAAQ,CAAC;oBACrD,yBAAyB;gBAC3B,OAAO;gBACP,eAAe,EACb,iCAAiC,CAAC,SAAS,CAAC,eAAe,CAAC;oBAC5D,uBAAuB;gBACzB,UAAU,EAAE,KAAK;aAClB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,aAAa,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAE9C,MAAM,YAAY,GAChB,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,cAAc,EAAE,SAAS,IAAI,EAAE,CAAC;IAC/D,OAAO;QACL,QAAQ,EAAE,yBAAyB;QACnC,OAAO,EAAE,mBAAmB,CAAC,YAAY,EAAE,IAAI,CAAC;QAChD,eAAe,EAAE,uBAAuB;QACxC,UAAU,EAAE,IAAI;KACjB,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Shared safe-presentation primitive for all user-facing opportunity surfaces.\n *\n * Historically every surface (home feed, list/discover cards, minimal chat\n * cards, notification emails/Telegram, chat context, delivery cards) invented\n * its own fallback chain for the case where genuine LLM presenter output is\n * unavailable — some sliced raw `interpretation.reasoning` with no\n * sanitization at all. This module is the single standard:\n *\n *   raw reasoning\n *     → whitespace-normalize\n *     → viewer-centric rewrite (incl. UUID stripping + introducer-mention stripping)\n *     → boundary-aware truncation\n *     → per-surface empty-text default\n *\n * Surfaces choose *policy* (send a sanitized fallback vs skip entirely) via\n * `allowFallback`; they no longer choose (or forget) sanitization steps.\n *\n * See `.agents/skills/review-opportunity-presentation/SKILL.md` for the review\n * checklist this module exists to satisfy.\n */\n\nimport { truncateAtBoundary, viewerCentricCardSummary } from \"./opportunity.presentation.js\";\nimport { stripUnsupportedOpportunityClaims } from \"./opportunity.claim-safety.js\";\n\n/** Default max length for fallback summaries (matches presenter internal fallback). */\nexport const SAFE_FALLBACK_MAX_CHARS = 300;\n\n/** Default copy when no reasoning text is available at all. */\nexport const DEFAULT_EMPTY_FALLBACK_TEXT = \"A promising connection.\";\n\n/** Default headline for fallback presentations (matches presenter internal fallback). */\nexport const DEFAULT_FALLBACK_HEADLINE = \"A promising connection\";\n\n/** Default CTA for fallback presentations (matches presenter internal fallback). */\nexport const DEFAULT_FALLBACK_ACTION =\n  \"Take a look and decide whether to reach out.\";\n\nexport interface SafeFallbackOptions {\n  /** Display name of the counterpart shown on the card (enables viewer-centric rewrite). */\n  counterpartName?: string;\n  /** Display name of the viewer; sentences describing the viewer are skipped/rewritten to \"you\". */\n  viewerName?: string;\n  /** Introducer display name; introducer mentions are stripped from the summary body. */\n  introducerName?: string | null;\n  /** Max output length (boundary-aware). Default {@link SAFE_FALLBACK_MAX_CHARS}. */\n  maxChars?: number;\n  /** Copy returned when reasoning is empty/blank. Default {@link DEFAULT_EMPTY_FALLBACK_TEXT}. */\n  emptyText?: string;\n}\n\n/**\n * Produce safe user-facing fallback copy from raw match reasoning.\n *\n * This is the ONE sanitization standard: UUID stripping, introducer-mention\n * stripping, and viewer-centric rewrite (via {@link viewerCentricCardSummary}),\n * followed by whitespace normalization and boundary-aware truncation (via\n * {@link truncateAtBoundary}). Never returns raw reasoning verbatim beyond\n * these guarantees, and never returns an empty string.\n *\n * @param rawReasoning - Raw `interpretation.reasoning` / `matchReason` text (may be null/undefined).\n * @param opts - Per-surface knobs (names for rewrite, max length, empty-text copy).\n */\nexport function safeFallbackSummary(\n  rawReasoning: string | null | undefined,\n  opts: SafeFallbackOptions = {},\n): string {\n  const emptyText = opts.emptyText ?? DEFAULT_EMPTY_FALLBACK_TEXT;\n  const maxChars = opts.maxChars ?? SAFE_FALLBACK_MAX_CHARS;\n\n  const normalized = (rawReasoning ?? \"\").replace(/\\s+/g, \" \").trim();\n  if (!normalized) return emptyText;\n  const claimSafeInput = stripUnsupportedOpportunityClaims(normalized);\n  if (!claimSafeInput) return emptyText;\n\n  // viewerCentricCardSummary handles UUID stripping, introducer-mention\n  // stripping, and the viewer-centric rewrite. Pass Infinity so truncation is\n  // handled by boundary-aware logic below instead of a mid-word hard slice.\n  const rewritten = viewerCentricCardSummary(\n    claimSafeInput,\n    opts.counterpartName ?? \"\",\n    Number.POSITIVE_INFINITY,\n    opts.viewerName,\n    opts.introducerName ?? undefined,\n  );\n\n  // Claim validation intentionally runs after viewer-centric rewriting: rewrite\n  // heuristics may select or join different source sentences, and the final\n  // user-facing sentence set is what must be safe.\n  const claimSafe = stripUnsupportedOpportunityClaims(rewritten);\n  const truncated = truncateAtBoundary(claimSafe, maxChars);\n  return truncated || emptyText;\n}\n\n/** Minimal presenter-output shape the primitive inspects (subset of HomeCardPresentationResult). */\nexport interface SafePresentationCandidate {\n  headline?: string;\n  personalizedSummary?: string;\n  suggestedAction?: string;\n  /** Set by OpportunityPresenter when its LLM call failed and it returned fallback-shaped copy. */\n  isFallback?: boolean;\n}\n\n/** Opportunity-ish source object accepted by {@link getSafePresentationOrSkip}. */\nexport interface SafePresentationSource {\n  /** Presenter output attached to the record, when available. */\n  homeCardPresentation?: SafePresentationCandidate | null;\n  /** Pre-truncated raw reasoning carried on discovery/list card data. */\n  matchReason?: string | null;\n  /** Full opportunity interpretation, when the caller holds the record. */\n  interpretation?: { reasoning?: string | null } | null;\n}\n\nexport interface SafePresentationOptions extends SafeFallbackOptions {\n  /**\n   * Policy switch: when false, return null instead of fallback copy so the\n   * surface can skip rendering entirely (e.g. scheduled digests where sending\n   * degraded copy is worse than sending nothing). Default true.\n   */\n  allowFallback?: boolean;\n}\n\n/** Resolved safe presentation for a surface to render. */\nexport interface SafePresentation {\n  headline: string;\n  summary: string;\n  suggestedAction: string;\n  /** True when copy was derived from raw reasoning rather than genuine LLM presenter output. */\n  isFallback: boolean;\n}\n\n/**\n * Resolve the safe user-facing presentation for an opportunity, or signal skip.\n *\n * Resolution order:\n * 1. Genuine presenter output (`homeCardPresentation` present, non-empty, and\n *    NOT tagged `isFallback` by the presenter) — claim-validated before return.\n * 2. Otherwise, if `allowFallback` (default true): sanitized fallback copy\n *    built from `matchReason` / `interpretation.reasoning` via\n *    {@link safeFallbackSummary}.\n * 3. Otherwise `null` — the surface must skip this opportunity.\n *\n * Raw `interpretation.reasoning` / `matchReason` never reaches the caller\n * unsanitized through this function.\n */\nexport function getSafePresentationOrSkip(\n  source: SafePresentationSource,\n  opts: SafePresentationOptions = {},\n): SafePresentation | null {\n  const candidate = source.homeCardPresentation;\n  if (candidate?.personalizedSummary?.trim() && !candidate.isFallback) {\n    const summary = stripUnsupportedOpportunityClaims(candidate.personalizedSummary);\n    if (summary) {\n      return {\n        headline:\n          stripUnsupportedOpportunityClaims(candidate.headline) ||\n          DEFAULT_FALLBACK_HEADLINE,\n        summary,\n        suggestedAction:\n          stripUnsupportedOpportunityClaims(candidate.suggestedAction) ||\n          DEFAULT_FALLBACK_ACTION,\n        isFallback: false,\n      };\n    }\n  }\n\n  if (opts.allowFallback === false) return null;\n\n  const rawReasoning =\n    source.matchReason ?? source.interpretation?.reasoning ?? \"\";\n  return {\n    headline: DEFAULT_FALLBACK_HEADLINE,\n    summary: safeFallbackSummary(rawReasoning, opts),\n    suggestedAction: DEFAULT_FALLBACK_ACTION,\n    isFallback: true,\n  };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "6.10.0-rc.397.1",
+  "version": "6.10.0-rc.398.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",