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

package/dist/opportunities/application/opportunity.presenter.d.ts

@@ -1,156 +0,0 @@
-/**
- * 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.
- */
-import { z } from "zod";
-import type { Opportunity } from "../../shared/interfaces/database.interface.js";
-import type { ChatGraphCompositeDatabase } from "../../shared/interfaces/database.interface.js";
-import type { NegotiationContext } from "./negotiation-context.loader.js";
-/**
- * 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">;
-declare const PresentationSchema: z.ZodObject<{
-    headline: z.ZodString;
-    personalizedSummary: z.ZodString;
-    suggestedAction: z.ZodString;
-    greeting: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    personalizedSummary: string;
-    headline: string;
-    suggestedAction: string;
-    greeting: string;
-}, {
-    personalizedSummary: string;
-    headline: string;
-    suggestedAction: string;
-    greeting: string;
-}>;
-export type OpportunityPresentationResult = z.infer<typeof PresentationSchema> & {
-    /** True when any output field used resilience fallback copy. */
-    isFallback?: boolean;
-    /** Diagnostic category; never changes production fallback policy. */
-    fallbackReason?: "timeout" | "error" | "sanitization";
-};
-/** Input for card presenter call; extends PresenterInput with optional mutual intent count. */
-export interface CardPresenterInput extends PresenterInput {
-    /** Number of overlapping intents (for generating mutualIntentsLabel). */
-    mutualIntentCount?: number;
-    /**
-     * 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
-     * transcript and outcome ground the LLM's explanation.
-     */
-    negotiationContext?: NegotiationContext;
-}
-/** LLM-generated fields for card presentation (buttons are hardcoded by callers, not LLM-generated). */
-export declare const CardLLMSchema: z.ZodObject<{
-    headline: z.ZodString;
-    personalizedSummary: z.ZodString;
-    digestSummary: z.ZodString;
-    suggestedAction: z.ZodString;
-    narratorRemark: z.ZodString;
-    mutualIntentsLabel: z.ZodString;
-    greeting: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    personalizedSummary: string;
-    headline: string;
-    suggestedAction: string;
-    greeting: string;
-    digestSummary: string;
-    narratorRemark: string;
-    mutualIntentsLabel: string;
-}, {
-    personalizedSummary: string;
-    headline: string;
-    suggestedAction: string;
-    greeting: string;
-    digestSummary: string;
-    narratorRemark: string;
-    mutualIntentsLabel: string;
-}>;
-/** LLM-generated result from presentCard (callers append button labels from opportunity.constants). */
-export type CardLLMResult = z.infer<typeof CardLLMSchema> & {
-    /**
-     * True when the LLM call failed and this is fallback-shaped copy built from
-     * raw match reasoning. Callers with strict quality requirements (digests,
-     * long-lived caches) should check this before sending/persisting — fallback
-     * output is otherwise indistinguishable from genuine LLM output.
-     */
-    isFallback?: boolean;
-};
-/** Full card display contract including hardcoded button labels (assembled by callers). */
-export type CardPresentationResult = CardLLMResult & {
-    primaryActionLabel: string;
-    secondaryActionLabel: string;
-};
-/** Input for a single presenter call (all context pre-assembled). */
-export interface PresenterInput {
-    viewerContext: string;
-    otherPartyContext: string;
-    matchReasoning: string;
-    category: string;
-    confidence: number;
-    signalsSummary: string;
-    indexName: 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;
-    private homeCardModel;
-    constructor();
-    private invokeWithTimeout;
-    /**
-     * Generate personalized presentation for a single opportunity.
-     */
-    present(input: PresenterInput, options?: {
-        signal?: AbortSignal;
-    }): Promise<OpportunityPresentationResult>;
-    /**
-     * Generate LLM-powered card content (headline, body, narrator remark, mutual-intent label).
-     * Callers append button labels from opportunity.constants.
-     *
-     * When `negotiationContext.status === 'negotiating'`, returns a templated
-     * chip synchronously without invoking the LLM — the card just reflects
-     * "negotiation in progress" at that point.
-     */
-    presentCard(input: CardPresenterInput): Promise<CardLLMResult>;
-    /**
-     * Process multiple opportunities in parallel with bounded concurrency.
-     */
-    presentBatch(inputs: PresenterInput[], options?: {
-        concurrency?: number;
-    }): Promise<OpportunityPresentationResult[]>;
-    /**
-     * Process multiple opportunities as cards in parallel with bounded concurrency.
-     * Returns full card display contracts (headline, body, narrator remark, action labels, mutual-intent label).
-     */
-    presentCardBatch(inputs: CardPresenterInput[], options?: {
-        concurrency?: number;
-    }): Promise<CardLLMResult[]>;
-}
-/**
- * Build the LLM-facing signal summary while excluding pool adjustments. Pool
- * disposition is rendered deterministically by the card chip; asking the
- * presenter to interpret it could turn a demotion into a positive rationale.
- */
-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>;
-export {};

package/dist/opportunities/domain/opportunity.presentation-cache.d.ts

@@ -1,5 +0,0 @@
-/** 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 buildApiChatCardPresentationCacheKey(opportunityId: string, viewerId: string): string;

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

@@ -1,11 +0,0 @@
-/** 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) {
-    return `radar:${OPPORTUNITY_PRESENTATION_CACHE_VERSION}:card:${opportunityId}:${status}:${viewerId}`;
-}
-export function buildDeliveryCardPresentationCacheKey(opportunityId, status, viewerId) {
-    return `delivery:${OPPORTUNITY_PRESENTATION_CACHE_VERSION}:card:${opportunityId}:${status}:${viewerId}`;
-}
-export function buildApiChatCardPresentationCacheKey(opportunityId, viewerId) {
-    return `chat:${OPPORTUNITY_PRESENTATION_CACHE_VERSION}:card:${opportunityId}:${viewerId}`;
-}

package/dist/opportunities/domain/opportunity.presentation.d.ts

@@ -1,76 +0,0 @@
-/**
- * Pure presentation layer for opportunities.
- * Generates title, description, and CTA based on viewer context — no DB access.
- */
-import type { Opportunity } from '../../shared/interfaces/database.interface.js';
-export interface OpportunityPresentation {
-    title: string;
-    description: string;
-    callToAction: string;
-}
-export interface UserInfo {
-    id: string;
-    name: string;
-    avatar: string | null;
-}
-/**
- * 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 stripUuids(text: string): string;
-/**
- * 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 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
- * 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.
- * @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;
-/**
- * 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 (already used by
- * home.graph.ts and opportunity.discover.ts). See buildMinimalOpportunityCard() in
- * opportunity.tools.ts for the trade-off discussion.
- *
- * @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 declare function narratorRemarkFromReasoning(reasoning: string, counterpartName: string, viewerName?: string): string;