@indexnetwork/protocol 0.1.0

package/dist/support/opportunity.enricher.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Opportunity enricher: when creating an opportunity, find overlapping existing
+ * opportunities (by non-introducer actor userId), check semantic relatedness, and
+ * optionally merge into a single enriched opportunity and expire the old one(s).
+ */
+import type { CreateOpportunityData, Opportunity, OpportunityStatus } from '../interfaces/database.interface.js';
+import type { Embedder } from '../interfaces/embedder.interface.js';
+import type { Id } from '../interfaces/database.interface.js';
+export type EnricherDatabase = {
+    findOverlappingOpportunities(actorUserIds: Id<'users'>[], options?: {
+        excludeStatuses?: ('latent' | 'pending' | 'accepted' | 'rejected' | 'expired')[];
+    }): Promise<Opportunity[]>;
+};
+export type EnrichmentResult = {
+    enriched: false;
+    data: CreateOpportunityData;
+} | {
+    enriched: true;
+    data: CreateOpportunityData;
+    expiredIds: string[];
+    resolvedStatus: OpportunityStatus;
+};
+export type EnrichOrCreateOptions = {
+    similarityThreshold?: number;
+};
+/**
+ * Enrich or create: find overlapping opportunities, filter by semantic relatedness
+ * using a two-phase approach, merge actors and interpretation into a single
+ * CreateOpportunityData, and return the data plus IDs to expire. If no related
+ * overlap, return original data unchanged.
+ *
+ * Phase 1 — Intent check (free, no API call):
+ *   Shared intent IDs mean the same declared user goal drove both opportunities.
+ *   This is rare because the IntentReconciler already deduplicates intents per-user
+ *   upstream, but when it fires it is definitive.
+ *
+ * Phase 2 — Batched embedding similarity (one API call for all remaining):
+ *   For opportunities without shared intents, embed all reasoning texts in a single
+ *   batch call and compare cosine similarity. Cross-user intent comparison (e.g.
+ *   Alice's "find ML co-founder" vs Bob's "join ML startup") is implicitly handled
+ *   here since reasoning text synthesizes both users' intents.
+ */
+export declare function enrichOrCreate(database: EnricherDatabase, embedder: Embedder, newData: CreateOpportunityData, options?: EnrichOrCreateOptions): Promise<EnrichmentResult>;
+//# sourceMappingURL=opportunity.enricher.d.ts.map

package/dist/support/opportunity.enricher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunity.enricher.d.ts","sourceRoot":"","sources":["../../src/support/opportunity.enricher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,WAAW,EAIX,iBAAiB,EAClB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AAQ9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,4BAA4B,CAC1B,YAAY,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,EAC3B,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,CAAC,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC,EAAE,CAAA;KAAE,GAC7F,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,qBAAqB,CAAA;CAAE,GAChD;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,qBAAqB,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAE7G,MAAM,MAAM,qBAAqB,GAAG;IAClC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAgJF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAqG3B"}

package/dist/support/opportunity.enricher.js

@@ -0,0 +1,245 @@
+/**
+ * Opportunity enricher: when creating an opportunity, find overlapping existing
+ * opportunities (by non-introducer actor userId), check semantic relatedness, and
+ * optionally merge into a single enriched opportunity and expire the old one(s).
+ */
+import { protocolLogger } from './protocol.logger.js';
+const logger = protocolLogger('OpportunityEnricher');
+const DEFAULT_SIMILARITY_THRESHOLD = 0.7;
+const MIN_REASONING_LENGTH_FOR_EMBEDDING = 10;
+/**
+ * Cosine similarity between two vectors (0–1).
+ */
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length || a.length === 0)
+        return 0;
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denom === 0)
+        return 0;
+    const sim = dot / denom;
+    return Math.max(0, Math.min(1, sim));
+}
+/**
+ * Resolve enriched opportunity status from related opportunities' statuses and the incoming status.
+ * Priority: accepted > pending > rejected > draft (only when incoming is draft) > latent.
+ * The incoming status is included so we do not wrongly downgrade when the new opportunity has a higher-priority status.
+ * When incoming is 'draft' (e.g. from in-chat discovery), we preserve draft so the opportunity stays chat-only and
+ * does not appear on the home view (home excludes draft).
+ * When incoming is NOT draft (e.g. 'latent' from the background broker), existing draft status does NOT contaminate
+ * the result — the broker-created opportunity retains its own status and can appear on the home view.
+ */
+function resolveEnrichedStatus(relatedStatuses, incomingStatus) {
+    const statuses = incomingStatus ? [...relatedStatuses, incomingStatus] : relatedStatuses;
+    if (statuses.includes('accepted'))
+        return 'accepted';
+    if (statuses.includes('pending'))
+        return 'pending';
+    if (statuses.includes('rejected'))
+        return 'rejected';
+    if (incomingStatus === 'draft')
+        return 'draft';
+    return 'latent';
+}
+/**
+ * Extract non-introducer actor userIds from create data.
+ */
+function getNonIntroducerUserIds(data) {
+    const ids = data.actors
+        .filter((a) => a.role !== 'introducer')
+        .map((a) => a.userId);
+    return [...new Set(ids)];
+}
+/**
+ * Extract intent IDs from actors.
+ */
+function getIntentIdsFromActors(actors) {
+    const ids = new Set();
+    for (const a of actors) {
+        if (a.intent)
+            ids.add(a.intent);
+    }
+    return ids;
+}
+/**
+ * Check if two opportunities share at least one intent ID.
+ */
+function shareIntentIds(newData, existing) {
+    const newIntents = getIntentIdsFromActors(newData.actors);
+    const existingIntents = getIntentIdsFromActors(existing.actors);
+    for (const id of newIntents) {
+        if (existingIntents.has(id))
+            return true;
+    }
+    return false;
+}
+/**
+ * Merge actors from new data and existing opportunities: union by (indexId, userId, intent),
+ * preserving all unique introducers and preferring newer role on conflict.
+ */
+function mergeActors(newData, existingList) {
+    const key = (a) => `${a.indexId}:${a.userId}:${a.intent ?? ''}`;
+    const map = new Map();
+    // Add all from existing first (older)
+    for (const opp of existingList) {
+        for (const a of opp.actors) {
+            map.set(key(a), a);
+        }
+    }
+    // Add/overwrite with new (newer wins for same key, e.g. role)
+    for (const a of newData.actors) {
+        map.set(key(a), a);
+    }
+    return [...map.values()];
+}
+/**
+ * Merge interpretation: single reasoning (new data only), max confidence, merged signals.
+ * We use only the new opportunity's reasoning to avoid repetitive concatenation when
+ * multiple overlapping opportunities share the same or similar text (e.g. same pair
+ * across indexes), which previously produced long duplicated paragraphs in chat cards.
+ */
+function mergeInterpretation(newData, existingList) {
+    const reasoning = newData.interpretation.reasoning;
+    let maxConf = typeof newData.interpretation.confidence === 'number'
+        ? newData.interpretation.confidence
+        : parseFloat(String(newData.interpretation.confidence ?? 0));
+    for (const o of existingList) {
+        const c = o.interpretation?.confidence;
+        const cNum = typeof c === 'number' ? c : parseFloat(String(c ?? 0));
+        if (cNum > maxConf)
+            maxConf = cNum;
+    }
+    const confidence = maxConf;
+    const signals = [
+        ...(newData.interpretation.signals ?? []),
+        ...existingList.flatMap((o) => o.interpretation?.signals ?? []),
+    ];
+    const seen = new Set();
+    const dedupedSignals = signals.filter((s) => {
+        const k = `${s.type}:${s.detail ?? ''}`;
+        if (seen.has(k))
+            return false;
+        seen.add(k);
+        return true;
+    });
+    return {
+        category: newData.interpretation.category,
+        reasoning,
+        confidence: typeof confidence === 'string' ? parseFloat(confidence) : confidence,
+        signals: dedupedSignals.length > 0 ? dedupedSignals : newData.interpretation.signals,
+    };
+}
+/**
+ * Enrich or create: find overlapping opportunities, filter by semantic relatedness
+ * using a two-phase approach, merge actors and interpretation into a single
+ * CreateOpportunityData, and return the data plus IDs to expire. If no related
+ * overlap, return original data unchanged.
+ *
+ * Phase 1 — Intent check (free, no API call):
+ *   Shared intent IDs mean the same declared user goal drove both opportunities.
+ *   This is rare because the IntentReconciler already deduplicates intents per-user
+ *   upstream, but when it fires it is definitive.
+ *
+ * Phase 2 — Batched embedding similarity (one API call for all remaining):
+ *   For opportunities without shared intents, embed all reasoning texts in a single
+ *   batch call and compare cosine similarity. Cross-user intent comparison (e.g.
+ *   Alice's "find ML co-founder" vs Bob's "join ML startup") is implicitly handled
+ *   here since reasoning text synthesizes both users' intents.
+ */
+export async function enrichOrCreate(database, embedder, newData, options) {
+    const actorUserIds = getNonIntroducerUserIds(newData);
+    if (actorUserIds.length === 0) {
+        return { enriched: false, data: newData };
+    }
+    const overlapping = await database.findOverlappingOpportunities(actorUserIds);
+    if (overlapping.length === 0) {
+        return { enriched: false, data: newData };
+    }
+    const threshold = options?.similarityThreshold ?? DEFAULT_SIMILARITY_THRESHOLD;
+    // Phase 1: Intent-based relatedness (free, strongest signal)
+    const related = [];
+    const remaining = [];
+    for (const opp of overlapping) {
+        if (shareIntentIds(newData, opp)) {
+            related.push(opp);
+        }
+        else {
+            remaining.push(opp);
+        }
+    }
+    // Phase 2: Batched embedding similarity (one API call for all remaining)
+    if (remaining.length > 0) {
+        const newReasoning = (newData.interpretation?.reasoning ?? '').trim();
+        // Only embed opps where both reasonings are long enough
+        const embeddable = [];
+        for (const opp of remaining) {
+            const existingReasoning = (opp.interpretation?.reasoning ?? '').trim();
+            if (newReasoning.length >= MIN_REASONING_LENGTH_FOR_EMBEDDING &&
+                existingReasoning.length >= MIN_REASONING_LENGTH_FOR_EMBEDDING) {
+                embeddable.push(opp);
+            }
+            // Short reasoning + no shared intents (Phase 1 missed) → not related
+        }
+        if (embeddable.length > 0) {
+            try {
+                const textsToEmbed = [
+                    newReasoning,
+                    ...embeddable.map((o) => (o.interpretation?.reasoning ?? '').trim()),
+                ];
+                const vectors = (await embedder.generate(textsToEmbed));
+                const newVec = vectors[0];
+                if (newVec?.length) {
+                    for (let i = 0; i < embeddable.length; i++) {
+                        const existingVec = vectors[i + 1];
+                        if (existingVec?.length && cosineSimilarity(newVec, existingVec) >= threshold) {
+                            related.push(embeddable[i]);
+                        }
+                    }
+                }
+            }
+            catch (e) {
+                logger.warn('[Enricher] Embedding check failed; intent-matched opportunities already captured', { error: e });
+                // Phase 1 matches are preserved; remaining opps without shared intents are not related
+            }
+        }
+    }
+    if (related.length === 0) {
+        return { enriched: false, data: newData };
+    }
+    const mergedActors = mergeActors(newData, related);
+    const mergedInterpretation = mergeInterpretation(newData, related);
+    const enrichedFrom = related.map((o) => o.id);
+    const mergedConfidence = typeof mergedInterpretation.confidence === 'number'
+        ? String(mergedInterpretation.confidence)
+        : mergedInterpretation.confidence;
+    const enrichedData = {
+        ...newData,
+        detection: {
+            ...newData.detection,
+            source: 'enrichment',
+            enrichedFrom,
+        },
+        actors: mergedActors,
+        interpretation: mergedInterpretation,
+        confidence: mergedConfidence,
+    };
+    const resolvedStatus = resolveEnrichedStatus(related.map((o) => o.status), newData.status);
+    logger.verbose('[Enricher] Enriched opportunity', {
+        enrichedFrom,
+        actorCount: mergedActors.length,
+    });
+    return {
+        enriched: true,
+        data: enrichedData,
+        expiredIds: enrichedFrom,
+        resolvedStatus,
+    };
+}
+//# sourceMappingURL=opportunity.enricher.js.map

package/dist/support/opportunity.enricher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunity.enricher.js","sourceRoot":"","sources":["../../src/support/opportunity.enricher.ts"],"names":[],"mappings":"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"}

package/dist/support/opportunity.persist.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Shared persist phase for opportunity creation: enrichOrCreate → create (or create+expire) → optional chat injection.
+ * Used by the opportunity graph persist node and by the manual opportunity service for consistency.
+ */
+import type { CreateOpportunityData, Opportunity, OpportunityStatus } from '../interfaces/database.interface.js';
+import type { Embedder } from '../interfaces/embedder.interface.js';
+import type { EnricherDatabase } from './opportunity.enricher.js';
+export type PersistOpportunityDatabase = EnricherDatabase & {
+    createOpportunity(data: CreateOpportunityData): Promise<Opportunity>;
+    updateOpportunityStatus(id: string, status: OpportunityStatus): Promise<void | Opportunity | null>;
+    createOpportunityAndExpireIds?(data: CreateOpportunityData, expireIds: string[]): Promise<{
+        created: Opportunity;
+        expired: Opportunity[];
+    }>;
+    /** Optional: used to populate expired list in non-atomic path. */
+    getOpportunity?(id: string): Promise<Opportunity | null>;
+};
+export interface PersistOpportunitiesParams {
+    database: PersistOpportunityDatabase;
+    embedder: Embedder;
+    items: CreateOpportunityData[];
+    injectChat?: (opportunity: Opportunity) => Promise<unknown>;
+}
+export interface PersistOpportunitiesError {
+    itemIndex: number;
+    error: unknown;
+}
+export interface PersistOpportunitiesResult {
+    created: Opportunity[];
+    expired: Opportunity[];
+    errors?: PersistOpportunitiesError[];
+}
+/**
+ * Persist one or more opportunities: enrich (merge overlapping), create, expire replaced, optional chat injection.
+ * When the database has createOpportunityAndExpireIds and enrichment produced expireIds, uses it for atomic create+expire.
+ * Returns both created and expired so callers can emit events (e.g. manual service).
+ */
+export declare function persistOpportunities(params: PersistOpportunitiesParams): Promise<PersistOpportunitiesResult>;
+//# sourceMappingURL=opportunity.persist.d.ts.map

package/dist/support/opportunity.persist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunity.persist.d.ts","sourceRoot":"","sources":["../../src/support/opportunity.persist.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EAClB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAMlE,MAAM,MAAM,0BAA0B,GAAG,gBAAgB,GAAG;IAC1D,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACrE,uBAAuB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,GAAG,WAAW,GAAG,IAAI,CAAC,CAAC;IACnG,6BAA6B,CAAC,CAC5B,IAAI,EAAE,qBAAqB,EAC3B,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC;QAAE,OAAO,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC,CAAC;IAC7D,kEAAkE;IAClE,cAAc,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC1D,CAAC;AAEF,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,yBAAyB,EAAE,CAAC;CACtC;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAoDlH"}

package/dist/support/opportunity.persist.js

@@ -0,0 +1,63 @@
+/**
+ * Shared persist phase for opportunity creation: enrichOrCreate → create (or create+expire) → optional chat injection.
+ * Used by the opportunity graph persist node and by the manual opportunity service for consistency.
+ */
+import { enrichOrCreate } from './opportunity.enricher.js';
+import { protocolLogger } from './protocol.logger.js';
+const logger = protocolLogger('OpportunityPersist');
+/**
+ * Persist one or more opportunities: enrich (merge overlapping), create, expire replaced, optional chat injection.
+ * When the database has createOpportunityAndExpireIds and enrichment produced expireIds, uses it for atomic create+expire.
+ * Returns both created and expired so callers can emit events (e.g. manual service).
+ */
+export async function persistOpportunities(params) {
+    const { database, embedder, items, injectChat } = params;
+    const created = [];
+    const expired = [];
+    const errors = [];
+    for (let itemIndex = 0; itemIndex < items.length; itemIndex++) {
+        const data = items[itemIndex];
+        try {
+            const enrichment = await enrichOrCreate(database, embedder, data);
+            const toCreate = enrichment.data;
+            if (enrichment.enriched) {
+                toCreate.status = enrichment.resolvedStatus;
+            }
+            if (database.createOpportunityAndExpireIds &&
+                enrichment.enriched &&
+                enrichment.expiredIds.length > 0) {
+                const result = await database.createOpportunityAndExpireIds(toCreate, enrichment.expiredIds);
+                created.push(result.created);
+                expired.push(...result.expired);
+            }
+            else {
+                const c = await database.createOpportunity(toCreate);
+                created.push(c);
+                if (enrichment.enriched && enrichment.expiredIds.length > 0) {
+                    for (const id of enrichment.expiredIds) {
+                        await database.updateOpportunityStatus(id, 'expired');
+                    }
+                    if (database.getOpportunity) {
+                        for (const id of enrichment.expiredIds) {
+                            const opp = await database.getOpportunity(id);
+                            if (opp)
+                                expired.push(opp);
+                        }
+                    }
+                }
+            }
+            const lastCreated = created[created.length - 1];
+            if (lastCreated?.status === 'pending' && injectChat) {
+                await injectChat(lastCreated).catch((err) => {
+                    logger.warn('[PersistOpportunities] Chat injection failed', { opportunityId: lastCreated.id, error: err });
+                });
+            }
+        }
+        catch (err) {
+            errors.push({ itemIndex, error: err });
+            logger.warn('[PersistOpportunities] Item failed', { itemIndex, error: err });
+        }
+    }
+    return { created, expired, ...(errors.length > 0 ? { errors } : {}) };
+}
+//# sourceMappingURL=opportunity.persist.js.map

package/dist/support/opportunity.persist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunity.persist.js","sourceRoot":"","sources":["../../src/support/opportunity.persist.ts"],"names":[],"mappings":"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"}

package/dist/support/opportunity.presentation.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Pure presentation layer for opportunities.
+ * Generates title, description, and CTA based on viewer context — no DB access.
+ */
+import type { Opportunity } from '../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;
+//# sourceMappingURL=opportunity.presentation.d.ts.map

package/dist/support/opportunity.presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunity.presentation.d.ts","sourceRoot":"","sources":["../../src/support/opportunity.presentation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAEvE,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,QAAQ,EACxB,cAAc,EAAE,QAAQ,GAAG,IAAI,EAC/B,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,cAAc,GACxC,uBAAuB,CAsEzB"}

package/dist/support/opportunity.presentation.js

@@ -0,0 +1,75 @@
+/**
+ * Pure presentation layer for opportunities.
+ * Generates title, description, and CTA based on viewer context — no DB access.
+ */
+/**
+ * Generate presentation copy for an opportunity based on viewer context.
+ * Pure function — no side effects, no database access.
+ */
+export function presentOpportunity(opp, viewerId, otherPartyInfo, introducerInfo, format) {
+    const myActor = opp.actors.find((a) => a.userId === viewerId);
+    const introducer = opp.actors.find((a) => a.role === 'introducer');
+    if (!myActor) {
+        throw new Error('Viewer is not an actor in this opportunity');
+    }
+    const otherName = otherPartyInfo.name;
+    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:
+            if (introducer && introducerInfo) {
+                title = `${introducerInfo.name} thinks you should meet ${otherName}`;
+                description = opp.interpretation.reasoning;
+                descriptionIsReasoning = true;
+            }
+            else {
+                title = `Opportunity with ${otherName}`;
+                description = opp.interpretation.reasoning;
+                descriptionIsReasoning = true;
+            }
+            break;
+    }
+    if (!descriptionIsReasoning) {
+        description += `\n\n${opp.interpretation.reasoning}`;
+    }
+    if (format === 'notification') {
+        description =
+            description.length > 100 ? description.slice(0, 97) + '...' : description;
+    }
+    return {
+        title,
+        description,
+        callToAction: 'View Opportunity',
+    };
+}
+//# sourceMappingURL=opportunity.presentation.js.map

package/dist/support/opportunity.presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunity.presentation.js","sourceRoot":"","sources":["../../src/support/opportunity.presentation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAgB,EAChB,QAAgB,EAChB,cAAwB,EACxB,cAA+B,EAC/B,MAAyC;IAEzC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;IAEnE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC;IACtC,IAAI,KAAa,CAAC;IAClB,IAAI,WAAmB,CAAC;IACxB,IAAI,sBAAsB,GAAG,KAAK,CAAC;IAEnC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,OAAO;YACV,KAAK,GAAG,gBAAgB,SAAS,EAAE,CAAC;YACpC,WAAW,GAAG,4BAA4B,SAAS,0CAA0C,CAAC;YAC9F,MAAM;QACR,KAAK,SAAS;YACZ,KAAK,GAAG,GAAG,SAAS,4BAA4B,CAAC;YACjD,WAAW,GAAG,GAAG,SAAS,sDAAsD,CAAC;YACjF,MAAM;QACR,KAAK,MAAM;YACT,KAAK,GAAG,gCAAgC,SAAS,EAAE,CAAC;YACpD,WAAW,GAAG,WAAW,SAAS,gCAAgC,CAAC;YACnE,MAAM;QACR,KAAK,QAAQ;YACX,KAAK,GAAG,GAAG,SAAS,mBAAmB,CAAC;YACxC,WAAW,GAAG,GAAG,SAAS,qDAAqD,CAAC;YAChF,MAAM;QACR,KAAK,QAAQ;YACX,KAAK,GAAG,GAAG,SAAS,0BAA0B,CAAC;YAC/C,WAAW,GAAG,6BAA6B,SAAS,iBAAiB,CAAC;YACtE,MAAM;QACR,KAAK,SAAS;YACZ,KAAK,GAAG,GAAG,SAAS,sCAAsC,CAAC;YAC3D,WAAW,GAAG,GAAG,SAAS,uDAAuD,CAAC;YAClF,MAAM;QACR,KAAK,UAAU;YACb,KAAK,GAAG,GAAG,SAAS,oCAAoC,CAAC;YACzD,WAAW,GAAG,GAAG,SAAS,8CAA8C,CAAC;YACzE,MAAM;QACR,KAAK,OAAO,CAAC;QACb;YACE,IAAI,UAAU,IAAI,cAAc,EAAE,CAAC;gBACjC,KAAK,GAAG,GAAG,cAAc,CAAC,IAAI,2BAA2B,SAAS,EAAE,CAAC;gBACrE,WAAW,GAAG,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC;gBAC3C,sBAAsB,GAAG,IAAI,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,KAAK,GAAG,oBAAoB,SAAS,EAAE,CAAC;gBACxC,WAAW,GAAG,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC;gBAC3C,sBAAsB,GAAG,IAAI,CAAC;YAChC,CAAC;YACD,MAAM;IACV,CAAC;IAED,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC5B,WAAW,IAAI,OAAO,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;IACvD,CAAC;IAED,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;QAC9B,WAAW;YACT,WAAW,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC;IAC9E,CAAC;IAED,OAAO;QACL,KAAK;QACL,WAAW;QACX,YAAY,EAAE,kBAAkB;KACjC,CAAC;AACJ,CAAC"}

package/dist/support/opportunity.sanitize.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Strips UUID patterns from user-facing text to prevent internal ID leaks.
+ */
+export declare function stripUuids(text: string): 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;
+//# sourceMappingURL=opportunity.sanitize.d.ts.map

package/dist/support/opportunity.sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunity.sanitize.d.ts","sourceRoot":"","sources":["../../src/support/opportunity.sanitize.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkB/C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,MAAM,CAqFR"}

package/dist/support/opportunity.sanitize.js

@@ -0,0 +1,89 @@
+/**
+ * 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();
+}
+/**
+ * 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 function stripIntroducerMentions(text, introducerName) {
+    if (!introducerName?.trim())
+        return text;
+    const fullName = introducerName.trim();
+    const firstName = fullName.split(/\s+/)[0];
+    const namesToCheck = [fullName];
+    if (firstName && firstName.length > 1) {
+        namesToCheck.push(firstName);
+    }
+    let result = text;
+    for (const [idx, name] of namesToCheck.entries()) {
+        const escapedName = escapeRegex(name);
+        // Pattern: "Name introduced you to " (with or without comma, optionally with "directly")
+        result = result.replace(new RegExp(`\\b${escapedName}\\s+introduced\\s+you\\s+(?:directly\\s+)?to\\s*`, "gi"), "");
+        // Pattern: "Name thinks you should meet "
+        result = result.replace(new RegExp(`\\b${escapedName}\\s+thinks\\s+you\\s+should\\s+meet\\s*`, "gi"), "");
+        // Pattern: "Name connected you to "
+        result = result.replace(new RegExp(`\\b${escapedName}\\s+connected\\s+you\\s+(?:to|with)\\s*`, "gi"), "");
+        // Pattern: "Name suggested you meet "
+        result = result.replace(new RegExp(`\\b${escapedName}\\s+suggested\\s+you\\s+(?:meet|connect\\s+(?:to|with))\\s*`, "gi"), "");
+        // Pattern: "Name recommended you meet "
+        result = result.replace(new RegExp(`\\b${escapedName}\\s+recommended\\s+you\\s+(?:meet|connect)\\s*`, "gi"), "");
+        // Pattern: "Name thinks you and Counterpart should meet" -> remove entire phrase up to Counterpart
+        result = result.replace(new RegExp(`\\b${escapedName}\\s+thinks\\s+you\\s+and\\s+`, "gi"), "");
+        // Pattern: "Name also thought..." - remove sentences starting with Name + also/also thought
+        result = result.replace(new RegExp(`\\b${escapedName}\\s+(?:also\\s+)?(?:thought|thinks?|believes?|felt)\\s*`, "gi"), "");
+        // General: Remove any remaining standalone mention of the introducer name at sentence start.
+        // Only apply for fullName (idx === 0) to avoid stripping valid counterpart first names
+        // (e.g. "David Smith" intro to "David Johnson" → we strip "David Smith" but not "David" in "David Johnson").
+        if (idx === 0) {
+            result = result.replace(new RegExp(`(?:^|\\.\\s*)\\b${escapedName}\\s+`, "gi"), (match, offset) => {
+                if (offset === 0 || match.startsWith(".")) {
+                    return match.startsWith(".") ? ". " : "";
+                }
+                return match;
+            });
+        }
+    }
+    // Clean up: remove leading/trailing whitespace and common punctuation artifacts
+    result = result
+        .replace(/^[\,\s]+/, "") // Remove leading commas/spaces
+        .replace(/\s{2,}/g, " ") // Normalize multiple spaces
+        .trim();
+    // Capitalize first letter if we removed from start
+    if (result.length > 0) {
+        result = result.charAt(0).toUpperCase() + result.slice(1);
+    }
+    return result;
+}
+// Helper function
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=opportunity.sanitize.js.map