@indexnetwork/protocol 22.0.0-rc.499.1 → 64.0.0-rc.604.2

package/dist/{opportunities → internal/opportunities}/opportunity.presentation.d.ts

@@ -14,8 +14,8 @@
  *   4. OpportunityPresenter (LLM card and chat copy)
  */
 import { z } from "zod";
-import type { Opportunity } from "../shared/interfaces/database.interface.js";
-import type { ChatGraphCompositeDatabase } from "../shared/interfaces/database.interface.js";
+import type { Opportunity } from "../../platform/database.js";
+import type { CompositeDatabase } from "../../platform/database.js";
 import type { NegotiationContext } from "./negotiation-context.loader.js";
 /**
  * Pure presentation layer for opportunities.
@@ -35,7 +35,7 @@ export interface UserInfo {
  * Generate presentation copy for an opportunity based on viewer context.
  * Pure function — no side effects, no database access.
  */
-export declare function presentOpportunity(opp: Opportunity, viewerId: string, otherPartyInfo: UserInfo, introducerInfo: UserInfo | null, format: 'card' | 'email' | 'notification'): OpportunityPresentation;
+export declare function presentOpportunity(opp: Opportunity, viewerId: string, otherPartyInfo: UserInfo, format: 'card' | 'email' | 'notification'): OpportunityPresentation;
 export declare function stripUuids(text: string): string;
 /**
  * Truncate user-facing text to at most `maxChars` without cutting mid-word.
@@ -46,19 +46,6 @@ export declare function stripUuids(text: string): string;
  * card never shows a sentence chopped mid-word (e.g. "His focus on 'indiv").
  */
 export declare function truncateAtBoundary(text: string, maxChars: number): string;
-/**
- * Strips introducer mentions from opportunity summary text.
- * Removes patterns like:
- * - "[Introducer] introduced you to [Counterpart]"
- * - "[Introducer] thinks you should meet [Counterpart]"
- * - "[Introducer] connected you to [Counterpart]"
- * - "[Introducer] suggested you meet [Counterpart]"
- *
- * @param text - The text to clean (personalizedSummary)
- * @param introducerName - Full name of the introducer to strip
- * @returns Text with introducer mentions removed, counterpart preserved
- */
-export declare function stripIntroducerMentions(text: string, introducerName: string | undefined): string;
 /**
  * Returns viewer-centric main text for an opportunity card.
  * Prefers the part of the reasoning that describes the counterpart (the person
@@ -69,10 +56,9 @@ export declare function stripIntroducerMentions(text: string, introducerName: st
  * @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.
- * @param introducerName - Optional display name of the introducer. When provided, introducer phrases (e.g., "X introduced you to...") are stripped from the summary to keep the body text focused on match quality.
  * @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 declare function viewerCentricCardSummary(reasoning: string, counterpartName: string, maxChars?: number, viewerName?: string, introducerName?: string): string;
+export declare function viewerCentricCardSummary(reasoning: string, counterpartName: string, maxChars?: number, viewerName?: string): string;
 /**
  * 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
@@ -82,9 +68,7 @@ export declare function viewerCentricCardSummary(reasoning: string, counterpartN
  * 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 (already used by
- * home.graph.ts and opportunity.discover.ts). See buildMinimalOpportunityCard() in
- * opportunity.tools.ts for the trade-off discussion.
+ * 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).
@@ -94,8 +78,7 @@ export declare function viewerCentricCardSummary(reasoning: string, counterpartN
 export declare function narratorRemarkFromReasoning(reasoning: string, counterpartName: string, viewerName?: string): string;
 /** Cache namespace for opportunity presentation copy. Bump to invalidate copy safety changes. */
 export declare const OPPORTUNITY_PRESENTATION_CACHE_VERSION = "v2";
-export declare function buildRadarCardPresentationCacheKey(opportunityId: string, status: string, viewerId: string): string;
-export declare function buildDeliveryCardPresentationCacheKey(opportunityId: string, status: string, viewerId: string): string;
+export declare function buildRadarCardPresentationCacheKey(opportunityId: string, status: string, viewerId: string, focusedViewerIntentId?: string): string;
 export declare function buildApiChatCardPresentationCacheKey(opportunityId: string, viewerId: string): string;
 /**
  * Shared safe-presentation primitive for all user-facing opportunity surfaces.
@@ -108,7 +91,7 @@ export declare function buildApiChatCardPresentationCacheKey(opportunityId: stri
  *
  *   raw reasoning
  *     → whitespace-normalize
- *     → viewer-centric rewrite (incl. UUID stripping + introducer-mention stripping)
+ *     → viewer-centric rewrite (incl. UUID stripping)
  *     → boundary-aware truncation
  *     → per-surface empty-text default
  *
@@ -131,8 +114,6 @@ export interface SafeFallbackOptions {
     counterpartName?: string;
     /** Display name of the viewer; sentences describing the viewer are skipped/rewritten to "you". */
     viewerName?: string;
-    /** Introducer display name; introducer mentions are stripped from the summary body. */
-    introducerName?: string | null;
     /** Max output length (boundary-aware). Default {@link SAFE_FALLBACK_MAX_CHARS}. */
     maxChars?: number;
     /** Copy returned when reasoning is empty/blank. Default {@link DEFAULT_EMPTY_FALLBACK_TEXT}. */
@@ -141,7 +122,7 @@ export interface SafeFallbackOptions {
 /**
  * Produce safe user-facing fallback copy from raw match reasoning.
  *
- * This is the ONE sanitization standard: UUID stripping, introducer-mention
+ * 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
@@ -206,14 +187,14 @@ export declare function getSafePresentationOrSkip(source: SafePresentationSource
  *
  * 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.
+ * actors, profiles, intents, network) to produce headline, personalizedSummary,
+ * and suggestedAction for user-facing surfaces.
  */
 /**
  * Minimal database interface required by gatherPresenterContext.
  * Any database adapter that implements these three methods can be passed.
  */
-export type PresenterDatabase = Pick<ChatGraphCompositeDatabase, "getProfile" | "getActiveIntents" | "getNetwork" | "getPremisesForUser">;
+export type PresenterDatabase = Pick<CompositeDatabase, "getProfile" | "getActiveIntents" | "getNetwork">;
 declare const PresentationSchema: z.ZodObject<{
     headline: z.ZodString;
     personalizedSummary: z.ZodString;
@@ -243,7 +224,7 @@ export interface CardPresenterInput extends PresenterInput {
     /**
      * Snapshot of the opportunity's negotiation, if one exists. When status is
      * `negotiating`, the presenter returns a templated chip without invoking
-     * the LLM. For `pending`/`stalled`/`accepted`/`rejected`, the full
+     * the LLM. For `pending`/`accepted`/`rejected`, the full
      * transcript and outcome ground the LLM's explanation.
      */
     negotiationContext?: NegotiationContext;
@@ -252,7 +233,6 @@ export interface CardPresenterInput extends PresenterInput {
 export declare const CardLLMSchema: z.ZodObject<{
     headline: z.ZodString;
     personalizedSummary: z.ZodString;
-    digestSummary: z.ZodString;
     suggestedAction: z.ZodString;
     narratorRemark: z.ZodString;
     mutualIntentsLabel: z.ZodString;
@@ -262,7 +242,6 @@ export declare const CardLLMSchema: z.ZodObject<{
     headline: string;
     suggestedAction: string;
     greeting: string;
-    digestSummary: string;
     narratorRemark: string;
     mutualIntentsLabel: string;
 }, {
@@ -270,7 +249,6 @@ export declare const CardLLMSchema: z.ZodObject<{
     headline: string;
     suggestedAction: string;
     greeting: string;
-    digestSummary: string;
     narratorRemark: string;
     mutualIntentsLabel: string;
 }>;
@@ -297,13 +275,9 @@ export interface PresenterInput {
     category: string;
     confidence: number;
     signalsSummary: string;
-    indexName: string;
+    networkName: string;
     viewerRole: string;
     opportunityStatus?: string;
-    /** True when this opportunity was created via an explicit introduction (not automatic discovery). */
-    isIntroduction?: boolean;
-    /** Name of the person who made the introduction, if applicable. */
-    introducerName?: string;
 }
 export declare class OpportunityPresenter {
     private model;
@@ -347,53 +321,10 @@ export declare class OpportunityPresenter {
 export declare function summarizeSignalsForPresenter(signals: Opportunity['interpretation']['signals']): string;
 /**
  * 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 a radar 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 declare function gatherPresenterContext(database: PresenterDatabase, opportunity: Opportunity, viewerId: string, displayCounterpartUserId?: string): Promise<PresenterInput>;
-/**
- * Minimal shape consumed by buildOpportunityPresentation for prose rendering.
- * Card data objects in the codebase carry additional frontend-only fields;
- * only these are surfaced to MCP agents.
- */
-export type OpportunityCardLike = Record<string, unknown> & {
-    opportunityId: string;
-    userId?: string | undefined;
-    name?: string | undefined;
-    mainText?: string | undefined;
-    digestSummary?: string | undefined;
-    status?: string | undefined;
-    feedCategory?: string | undefined;
-    profileUrl?: string | undefined;
-    /** Universal link that opens this opportunity's card (`/o/<id>`). */
-    appUrl?: string | undefined;
-    /** Deep-link to the A2A negotiation trace that produced this opportunity. */
-    negotiationUrl?: string | undefined;
-    score?: number | undefined;
-    /** Digest-mode cooldown re-show — the user has seen this card before. */
-    redelivery?: boolean | undefined;
-};
-/**
- * Format opportunity cards into the "opportunities" portion of a tool response.
- *
- * Web chat (`isMcp=false`): emits ```opportunity``` code fences with an
- * "include EXACTLY as-is" directive so the frontend card renderer can parse
- * and render interactive cards.
+ * Fetches viewer profile, viewer intents, other party profile(s), and network in parallel.
  *
- * MCP (`isMcp=true`): emits prose (name, reason, status, appUrl and profileUrl
- * when present, feedCategory when present) and includes `opportunityId` for
- * every card so the agent can act via the tools. The trailing instruction
- * reminds the agent to synthesize in natural language, to surface the `appUrl`
- * verbatim as the one link that opens the card, and to fabricate no other URL.
- * MCP clients have no card renderer, so code fences would surface as raw JSON
- * to end users.
+ * @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 focusedViewerIntentId - When set, include only that active intent in viewer context.
  */
-export declare function buildOpportunityPresentation(inputCards: OpportunityCardLike[], opts: {
-    isMcp: boolean;
-    leadIn: string;
-    label?: 'opportunity' | 'opportunities';
-    /** Include hidden digest metadata markers so scheduled brief tooling can confirm delivery. */
-    includeDigestMarkers?: boolean;
-}): string;
+export declare function gatherPresenterContext(database: PresenterDatabase, opportunity: Opportunity, viewerId: string, displayCounterpartUserId?: string, focusedViewerIntentId?: string): Promise<PresenterInput>;
 export {};