@indexnetwork/protocol 66.0.0-rc.608.1 → 66.0.0-rc.609.1

package/CHANGELOG.md

@@ -6,7 +6,9 @@
 
 - Opportunity copy comes only from the LLM presenter. `OpportunityPresenter.present()` and `presentCard()` throw on LLM failure, timeout, or invalid output instead of returning fallback copy; `isFallback` and `fallbackReason` are gone from their results.
 - Remove `presentOpportunity`, `stripUuids`, `truncateAtBoundary`, `safeFallbackSummary`, `DEFAULT_FALLBACK_HEADLINE`, `hasUnsupportedOpportunityClaim`, `stripUnsupportedOpportunityClaims`, and `stripUnsupportedOpportunityClaimsText` from the public entry point. The regex claim-safety guard is deleted; the presenter prompts carry the rule.
-- `readOpportunities` items no longer carry `reasoning`. Radar drops a card when its presenter call fails instead of rendering reasoning-derived fallback copy.
+- `readOpportunities` items no longer carry `reasoning`.
+- Remove `RadarGraphFactory` and the radar graph. Use `listOpportunityCards(deps, { viewerId, statuses, networkId?, intentId?, limit, noCache?, skeleton? })` for a presented card list and `presentOpportunityCard(deps, opportunity, viewerId, { intentId?, skeleton? })` for one card; both return `OpportunityCard`. `statuses` is required, and the list is newest first with one card per counterpart. A card whose presenter call fails is dropped from the list; `presentOpportunityCard` throws.
+- Rename `RadarGraphDatabase` to `OpportunityCardsDatabase` and `buildRadarCardPresentationCacheKey` to `buildOpportunityCardCacheKey` (keys now start with `card:`). Remove `RADAR_SOFT_TARGETS` and `selectByComposition`.
 
 ## 65.0.0
 

package/IMPLEMENTATION.md

@@ -128,26 +128,25 @@ negotiation state and presentation contracts.
 Optional capabilities default to a
 degraded-but-functional mode when omitted.
 
-## Graphs
+## Opportunity cards
 
-A `*GraphFactory` class is exported for each workflow:
+Presented opportunity cards are plain async functions over
+`{ database: OpportunityCardsDatabase, cache: OpportunityCache, presenter: OpportunityPresenter }`:
 
 ```typescript
 import {
-  RadarGraphFactory,
+  listOpportunityCards,
+  presentOpportunityCard,
 } from "@indexnetwork/protocol";
 ```
 
-Each factory takes its typed dependencies in the constructor and exposes a
-`.createGraph()` method that returns a compiled LangGraph ready for `.invoke()`.
+`listOpportunityCards` returns the viewer's opportunities in the requested
+statuses, newest first with one card per counterpart, serving cached cards and
+dropping any whose presenter call fails. `presentOpportunityCard` presents one
+opportunity and throws when the presenter fails.
 
-The intent and community graphs are the exceptions: they are reached through the
-`Intents` and `Networks` module classes rather than factories of their own (see
-[Intents](#intents) and [Networks](#networks) below).
-
-| Factory | Workflow |
-|---|---|
-| `RadarGraphFactory` | Build the radar view: flat presenter-card list, optionally intent-scoped |
+The intent and community graphs are reached through the `Intents` and `Networks`
+module classes (see [Intents](#intents) and [Networks](#networks) below).
 
 ## On-demand discovery
 

package/STABILITY.md

@@ -46,7 +46,6 @@ Covered by SemVer below. Breaking changes require a **major** bump.
 | **Public API** | Model config helpers, request scope helpers (`deriveAllowedNetworkIds`, `deriveDiscoveryNetworkIds`), `requestContext`. |
 | **Interfaces** | Every port you implement to inject infrastructure (databases, embedder, cache, scraper, integration, …). |
 | **Shared schemas** | Zod schemas + inferred types that cross the boundary (underspecification, identity, network-assignment, chat-context, …). |
-| **Graph factories** | `*GraphFactory` classes (for example, `RadarGraphFactory`). |
 | **Intents** | `Intents` — the whole signal capability as one class (lifecycle graph, verification, preparation) plus `IntentsDeps` and the `Prepare*` / `RecoveryField*` types. Replaced the six separate intent exports in 18.0.0. |
 | **Agents** | Structured LLM agents (`OpportunityEvaluator`, …). |
 

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export { requestContext, setRequestContextStore } from "./internal/shared/observ
 export { setLoggerFactory } from "./internal/shared/observability/log.js";
 export { setTimingWrapper } from "./internal/shared/observability/performance.js";
 export type { Cache, CacheOptions, OpportunityCache } from "./platform/discovery/cache.js";
-export type { CompositeDatabase, UserDatabase, SystemDatabase, OpportunityDatabase, OpportunityControllerDatabase, RadarGraphDatabase, IntentGraphDatabase, Opportunity, OpportunityActor, OpportunityStatus, AssignmentNetworkMembership, IntentNetworkFinalAssignmentResult, CreateOpportunityData, IntentLifecycleStatus, TransitionLifecycleResult, NegotiationContextDatabase, NegotiationContextRecord, NegotiationContextOutcome, NegotiationContextTurn, } from "./platform/database.js";
+export type { CompositeDatabase, UserDatabase, SystemDatabase, OpportunityDatabase, OpportunityControllerDatabase, OpportunityCardsDatabase, IntentGraphDatabase, Opportunity, OpportunityActor, OpportunityStatus, AssignmentNetworkMembership, IntentNetworkFinalAssignmentResult, CreateOpportunityData, IntentLifecycleStatus, TransitionLifecycleResult, NegotiationContextDatabase, NegotiationContextRecord, NegotiationContextOutcome, NegotiationContextTurn, } from "./platform/database.js";
 export type { Embedder, VectorStoreOption, VectorSearchResult } from "./platform/discovery/embedder.js";
 export type { IntentFollowUp } from "./platform/runtime/follow-up.js";
 export type { Scraper } from "./platform/discovery/scraper.js";
@@ -44,10 +44,11 @@ export type { CreateIntentCounterpartyData, OpenedNegotiation, } from "./interna
 export { gatherPresenterContext, OpportunityPresenter, } from "./internal/opportunities/opportunity.presentation.js";
 export type { PresenterDatabase, } from "./internal/opportunities/opportunity.presentation.js";
 export { getPrimaryActionLabel, } from "./internal/opportunities/opportunity.labels.js";
-export { buildApiChatCardPresentationCacheKey, buildRadarCardPresentationCacheKey, } from "./internal/opportunities/opportunity.presentation.js";
+export { buildApiChatCardPresentationCacheKey, buildOpportunityCardCacheKey, } from "./internal/opportunities/opportunity.presentation.js";
 export type { UserInfo, } from "./internal/opportunities/opportunity.presentation.js";
-export { canUserSeeOpportunity, classifyOpportunity, isActionableForViewer, RADAR_SOFT_TARGETS, selectByComposition, validateOpportunityActors, } from "./internal/opportunities/opportunity.utils.js";
-export { RadarGraphFactory, } from "./internal/opportunities/radar/radar.graph.js";
+export { canUserSeeOpportunity, classifyOpportunity, isActionableForViewer, validateOpportunityActors, } from "./internal/opportunities/opportunity.utils.js";
+export { listOpportunityCards, presentOpportunityCard, } from "./internal/opportunities/opportunity.cards.js";
+export type { OpportunityCard, } from "./internal/opportunities/opportunity.cards.js";
 export { readOpportunities } from './internal/opportunities/opportunity.graph.modes.js';
 export { admitOpportunityEvent, projectOpportunity } from './internal/opportunities/opportunity.events.js';
 export type { OpportunityAdmission, OpportunityEventType, OpportunityLogEvent, OpportunityProjection, OpportunityProjectionStatus } from './internal/opportunities/opportunity.events.js';

package/dist/index.js

@@ -48,9 +48,9 @@ export { normalizeTelegramHandle } from './internal/shared/utils/telegram-handle
 export { pairKeyOf, } from "./internal/opportunities/opportunity.counterparties.js";
 export { gatherPresenterContext, OpportunityPresenter, } from "./internal/opportunities/opportunity.presentation.js";
 export { getPrimaryActionLabel, } from "./internal/opportunities/opportunity.labels.js";
-export { buildApiChatCardPresentationCacheKey, buildRadarCardPresentationCacheKey, } from "./internal/opportunities/opportunity.presentation.js";
-export { canUserSeeOpportunity, classifyOpportunity, isActionableForViewer, RADAR_SOFT_TARGETS, selectByComposition, validateOpportunityActors, } from "./internal/opportunities/opportunity.utils.js";
-export { RadarGraphFactory, } from "./internal/opportunities/radar/radar.graph.js";
+export { buildApiChatCardPresentationCacheKey, buildOpportunityCardCacheKey, } from "./internal/opportunities/opportunity.presentation.js";
+export { canUserSeeOpportunity, classifyOpportunity, isActionableForViewer, validateOpportunityActors, } from "./internal/opportunities/opportunity.utils.js";
+export { listOpportunityCards, presentOpportunityCard, } from "./internal/opportunities/opportunity.cards.js";
 export { readOpportunities } from './internal/opportunities/opportunity.graph.modes.js';
 export { admitOpportunityEvent, projectOpportunity } from './internal/opportunities/opportunity.events.js';
 export { resolveDiscoveryNetworkScope, renderDiscoveryNetworkContext } from './protocol/discovery.rules.js';

package/dist/internal/opportunities/opportunity.cards.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Opportunity cards: presenter-texted cards for a viewer, as a list or one at
+ * a time. The list loads, filters, and dedupes the viewer's opportunities,
+ * serves cached cards, and presents the misses through OpportunityPresenter.
+ */
+import type { Opportunity, OpportunityCardsDatabase, OpportunityStatus } from '../../platform/database.js';
+import type { OpportunityCache } from '../../platform/discovery/cache.js';
+import { OpportunityPresenter } from './opportunity.presentation.js';
+/** One opportunity with its presenter-driven display contract. */
+export interface OpportunityCard {
+    opportunityId: string;
+    createdAt?: string;
+    /** Lifecycle status of the underlying opportunity at render time. */
+    status?: OpportunityStatus;
+    userId: string;
+    name: string;
+    avatar: string | null;
+    mainText: string;
+    cta: string;
+    headline?: string;
+    primaryActionLabel: string;
+    secondaryActionLabel: string;
+    mutualIntentsLabel: string;
+    narratorChip?: {
+        name: string;
+        text: string;
+        avatar?: string | null;
+        userId?: string;
+    };
+    /** Viewer's role in this opportunity (e.g. 'party', 'agent', 'patient', 'peer'). */
+    viewerRole?: string;
+    /**
+     * True for a skeleton card: identity fields are real but mainText/cta are
+     * empty because the presenter was skipped. Never cached.
+     */
+    presentationPending?: boolean;
+}
+/** Everything card presentation reaches for. */
+export interface OpportunityCardsDeps {
+    database: OpportunityCardsDatabase;
+    cache: OpportunityCache;
+    presenter: OpportunityPresenter;
+}
+/**
+ * Present one opportunity as a card for the viewer.
+ *
+ * @param deps - Database, cache, and presenter.
+ * @param opportunity - The opportunity to present.
+ * @param viewerId - The viewing user.
+ * @param options - `intentId` focuses viewer context on one intent; `skeleton` skips the presenter.
+ * @returns The card, or null when the counterpart's name cannot be resolved.
+ * @throws When the presenter fails.
+ */
+export declare function presentOpportunityCard(deps: OpportunityCardsDeps, opportunity: Opportunity, viewerId: string, options?: {
+    intentId?: string;
+    skeleton?: boolean;
+}): Promise<OpportunityCard | null>;
+/**
+ * List the viewer's opportunities in the given statuses as presented cards,
+ * newest first, one card per counterpart. Cards whose presentation fails are
+ * dropped.
+ *
+ * @param deps - Database, cache, and presenter.
+ * @param input - Viewer, statuses, optional network/intent scope, limit, cache bypass, skeleton mode.
+ * @returns The cards and the number of opportunities selected.
+ */
+export declare function listOpportunityCards(deps: OpportunityCardsDeps, input: {
+    viewerId: string;
+    statuses: OpportunityStatus[];
+    networkId?: string;
+    intentId?: string;
+    limit: number;
+    noCache?: boolean;
+    skeleton?: boolean;
+}): Promise<{
+    cards: OpportunityCard[];
+    totalOpportunities: number;
+}>;

package/dist/internal/opportunities/opportunity.cards.js

@@ -0,0 +1,165 @@
+/**
+ * Opportunity cards: presenter-texted cards for a viewer, as a list or one at
+ * a time. The list loads, filters, and dedupes the viewer's opportunities,
+ * serves cached cards, and presents the misses through OpportunityPresenter.
+ */
+import { protocolLogger } from '../shared/observability/protocol.logger.js';
+import { buildOpportunityCardCacheKey, gatherPresenterContext } from './opportunity.presentation.js';
+import { loadNegotiationContext } from './negotiation-context.loader.js';
+import { canUserSeeOpportunity, isActionableForViewer } from './opportunity.utils.js';
+import { getPrimaryActionLabel, SECONDARY_ACTION_LABEL } from './opportunity.labels.js';
+const logger = protocolLogger('OpportunityCards');
+const PRESENTATION_CONCURRENCY = 50;
+const CARD_CACHE_TTL = 24 * 60 * 60;
+const ROLE_PRIORITY = new Map([
+    ['patient', 0],
+    ['party', 1],
+    ['agent', 2],
+    ['peer', 3],
+]);
+/** Prefer direct counterpart roles, then a stable sort by user id. */
+function pickDisplayCounterpartActor(opportunity, viewerId) {
+    const candidates = opportunity.actors.filter((actor) => actor.userId !== viewerId);
+    return [...candidates].sort((a, b) => {
+        const aPriority = ROLE_PRIORITY.get(a.role) ?? 99;
+        const bPriority = ROLE_PRIORITY.get(b.role) ?? 99;
+        if (aPriority !== bPriority)
+            return aPriority - bPriority;
+        return a.userId.localeCompare(b.userId);
+    })[0] ?? null;
+}
+function counterpartUserIds(opportunity, viewerId) {
+    return new Set(opportunity.actors.map((a) => a.userId).filter((id) => id && id !== viewerId));
+}
+/**
+ * Present one opportunity as a card for the viewer.
+ *
+ * @param deps - Database, cache, and presenter.
+ * @param opportunity - The opportunity to present.
+ * @param viewerId - The viewing user.
+ * @param options - `intentId` focuses viewer context on one intent; `skeleton` skips the presenter.
+ * @returns The card, or null when the counterpart's name cannot be resolved.
+ * @throws When the presenter fails.
+ */
+export async function presentOpportunityCard(deps, opportunity, viewerId, options = {}) {
+    const { database } = deps;
+    const viewerRole = opportunity.actors.find((a) => a.userId === viewerId)?.role ?? 'party';
+    const counterpart = pickDisplayCounterpartActor(opportunity, viewerId);
+    if (!counterpart)
+        return null;
+    const user = await database.getUser(counterpart.userId).catch(() => null);
+    let name = user?.name?.trim();
+    if (!name) {
+        const profile = await database.getProfile(counterpart.userId).catch(() => null);
+        name = profile?.identity?.name?.trim();
+    }
+    if (!name)
+        return null;
+    const identity = {
+        opportunityId: opportunity.id,
+        createdAt: opportunity.createdAt.toISOString(),
+        status: opportunity.status,
+        userId: counterpart.userId,
+        name,
+        avatar: user?.avatar ?? null,
+        primaryActionLabel: getPrimaryActionLabel(viewerRole),
+        secondaryActionLabel: SECONDARY_ACTION_LABEL,
+        viewerRole,
+    };
+    if (options.skeleton) {
+        return { ...identity, mainText: '', cta: '', mutualIntentsLabel: 'Shared interests', presentationPending: true };
+    }
+    const [context, negotiationContext] = await Promise.all([
+        gatherPresenterContext(database, opportunity, viewerId, counterpart.userId, options.intentId),
+        loadNegotiationContext(database, opportunity.id, opportunity.status, viewerId),
+    ]);
+    const presentation = await deps.presenter.presentCard({
+        ...context,
+        opportunityStatus: opportunity.status,
+        ...(negotiationContext ? { negotiationContext } : {}),
+    });
+    return {
+        ...identity,
+        mainText: presentation.personalizedSummary,
+        cta: presentation.suggestedAction,
+        headline: presentation.headline,
+        mutualIntentsLabel: presentation.mutualIntentsLabel,
+        narratorChip: { name: 'Index', text: presentation.narratorRemark },
+    };
+}
+/**
+ * List the viewer's opportunities in the given statuses as presented cards,
+ * newest first, one card per counterpart. Cards whose presentation fails are
+ * dropped.
+ *
+ * @param deps - Database, cache, and presenter.
+ * @param input - Viewer, statuses, optional network/intent scope, limit, cache bypass, skeleton mode.
+ * @returns The cards and the number of opportunities selected.
+ */
+export async function listOpportunityCards(deps, input) {
+    const { viewerId, intentId } = input;
+    const raw = await deps.database.getOpportunitiesForUser(viewerId, {
+        limit: Math.min(150, Math.max(50, input.limit * 3)),
+        statuses: input.statuses,
+        ...(input.networkId ? { networkId: input.networkId } : {}),
+        ...(intentId ? { scopeType: 'intent', scopeId: intentId } : {}),
+    });
+    const requested = new Set(input.statuses);
+    const visible = raw
+        .filter((opp) => requested.has(opp.status) && canUserSeeOpportunity(opp.actors, opp.status, viewerId))
+        .filter((opp) => opp.status !== 'pending'
+        || isActionableForViewer(opp.actors, opp.status, viewerId, opp.committedActorIds ?? []))
+        .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    const seen = new Set();
+    const opportunities = visible.filter((opp) => {
+        const ids = counterpartUserIds(opp, viewerId);
+        if ([...ids].some((id) => seen.has(id)))
+            return false;
+        for (const id of ids)
+            seen.add(id);
+        return true;
+    }).slice(0, input.limit);
+    const cacheable = (opp) => opp.status !== 'negotiating';
+    const keyFor = (opp) => buildOpportunityCardCacheKey(opp.id, opp.status, viewerId, intentId);
+    const cacheableOpps = input.noCache ? [] : opportunities.filter(cacheable);
+    const cached = new Map();
+    if (cacheableOpps.length > 0) {
+        try {
+            const hits = await deps.cache.mget(cacheableOpps.map(keyFor));
+            cacheableOpps.forEach((opp, i) => {
+                const hit = hits[i];
+                if (hit)
+                    cached.set(opp.id, { ...hit, status: opp.status });
+            });
+        }
+        catch (error) {
+            logger.warn('card cache read failed, presenting all', { error });
+        }
+    }
+    const cards = [];
+    for (let i = 0; i < opportunities.length; i += PRESENTATION_CONCURRENCY) {
+        const chunk = opportunities.slice(i, i + PRESENTATION_CONCURRENCY);
+        cards.push(...await Promise.all(chunk.map(async (opp) => {
+            const hit = cached.get(opp.id);
+            if (hit)
+                return hit;
+            try {
+                const card = await presentOpportunityCard(deps, opp, viewerId, { intentId, skeleton: input.skeleton });
+                if (card && !card.presentationPending && cacheable(opp)) {
+                    await deps.cache.set(keyFor(opp), card, { ttl: CARD_CACHE_TTL }).catch((error) => {
+                        logger.warn('card cache write failed', { opportunityId: opp.id, error });
+                    });
+                }
+                return card;
+            }
+            catch (error) {
+                logger.warn('presenter failed, dropping card', { opportunityId: opp.id, error });
+                return null;
+            }
+        })));
+    }
+    return {
+        cards: cards.filter((card) => card !== null),
+        totalOpportunities: opportunities.length,
+    };
+}

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

@@ -20,7 +20,7 @@ export interface UserInfo {
 }
 /** 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, focusedViewerIntentId?: string): string;
+export declare function buildOpportunityCardCacheKey(opportunityId: string, status: string, viewerId: string, focusedViewerIntentId?: string): string;
 export declare function buildApiChatCardPresentationCacheKey(opportunityId: string, viewerId: string): string;
 /**
  * Opportunity Presenter Agent
@@ -159,7 +159,7 @@ export declare function summarizeSignalsForPresenter(signals: Opportunity['inter
  * Gather all context needed for the presenter from the database.
  * Fetches viewer profile, viewer intents, other party profile(s), and network 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.
+ * @param displayCounterpartUserId - When set (e.g. for an opportunity 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 gatherPresenterContext(database: PresenterDatabase, opportunity: Opportunity, viewerId: string, displayCounterpartUserId?: string, focusedViewerIntentId?: string): Promise<PresenterInput>;

package/dist/internal/opportunities/opportunity.presentation.js

@@ -27,9 +27,9 @@ import { createStructuredModel } from "../shared/agent/model.config.js";
 // ──────────────────────────────────────────────────────────────────────
 /** 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, focusedViewerIntentId) {
+export function buildOpportunityCardCacheKey(opportunityId, status, viewerId, focusedViewerIntentId) {
     const scope = focusedViewerIntentId ? `:intent:${focusedViewerIntentId}` : "";
-    return `radar:${OPPORTUNITY_PRESENTATION_CACHE_VERSION}:card:${opportunityId}:${status}:${viewerId}${scope}`;
+    return `card:${OPPORTUNITY_PRESENTATION_CACHE_VERSION}:${opportunityId}:${status}:${viewerId}${scope}`;
 }
 export function buildApiChatCardPresentationCacheKey(opportunityId, viewerId) {
     return `chat:${OPPORTUNITY_PRESENTATION_CACHE_VERSION}:card:${opportunityId}:${viewerId}`;
@@ -387,7 +387,7 @@ export function summarizeSignalsForPresenter(signals) {
  * Gather all context needed for the presenter from the database.
  * Fetches viewer profile, viewer intents, other party profile(s), and network 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.
+ * @param displayCounterpartUserId - When set (e.g. for an opportunity 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 async function gatherPresenterContext(database, opportunity, viewerId, displayCounterpartUserId, focusedViewerIntentId) {

package/dist/internal/opportunities/opportunity.utils.d.ts

@@ -46,11 +46,6 @@ export declare function isActionableForViewer(actors: Array<{
 }>, status: string, viewerId: string, committedActorIds?: readonly string[]): boolean;
 /** Feed category for home composition. */
 export type FeedCategory = 'connection' | 'expired';
-/** Soft targets for radar composition. */
-export declare const RADAR_SOFT_TARGETS: {
-    readonly connection: 5;
-    readonly expired: 2;
-};
 /**
  * Classify an actionable opportunity into a feed category.
  * Assumes the opportunity already passed isActionableForViewer or is expired.
@@ -66,40 +61,3 @@ export declare function classifyOpportunity(opp: {
     }>;
     status: string;
 }, _viewerId: string): FeedCategory;
-/**
- * Select opportunities for the radar using soft composition targets.
- * Fills each category up to its target, then redistributes unused slots
- * to categories that have more items available. Preserves input order.
- *
- * @param opportunities - Pre-sorted opportunities (by confidence/recency)
- * @param viewerId - The viewing user's ID
- * @returns Composition-balanced subset
- */
-export declare function selectByComposition<T extends {
-    actors: Array<{
-        userId: string;
-        role: string;
-    }>;
-    status: string;
-}>(opportunities: T[], viewerId: string): T[];
-/**
- * Deduplicate opportunities so each counterpart appears at most once.
- * Keeps the opportunity with the highest interpretation.confidence per
- * counterpart userId. On ties, the first encountered wins (stable).
- *
- * Counterpart = first actor whose userId !== viewerId.
- * Opportunities without a derivable counterpart pass through undeduped.
- *
- * @param opportunities - Pre-sorted opportunities (e.g. by confidence/recency)
- * @param viewerId - The viewing user's ID
- * @returns Deduped subset preserving original input order among winners
- */
-export declare function deduplicateByPerson<T extends {
-    actors: Array<{
-        userId: string;
-        role: string;
-    }>;
-    interpretation?: {
-        confidence?: number;
-    } | null;
-}>(opportunities: T[], viewerId: string): T[];

package/dist/internal/opportunities/opportunity.utils.js

@@ -1,6 +1,3 @@
-import { log } from '../shared/observability/log.js';
-const logger = log.graph.from('SelectByComposition');
-const dedupeByPersonLog = log.graph.from('DeduplicateByPerson');
 /**
  * Validates opportunity actors.
  *
@@ -51,14 +48,6 @@ export function isActionableForViewer(actors, status, viewerId, committedActorId
         return false;
     return !committedActorIds.includes(viewerId);
 }
-/** Soft targets for radar composition. */
-export const RADAR_SOFT_TARGETS = {
-    // 3 + 2 in a second category before that category was removed. The slots move to
-    // connections rather than shrinking the feed: the total a radar can hold is
-    // unchanged, and connections are the only kind of card left.
-    connection: 5,
-    expired: 2,
-};
 /**
  * Classify an actionable opportunity into a feed category.
  * Assumes the opportunity already passed isActionableForViewer or is expired.
@@ -72,94 +61,3 @@ export function classifyOpportunity(opp, _viewerId) {
         return 'expired';
     return 'connection';
 }
-/**
- * Select opportunities for the radar using soft composition targets.
- * Fills each category up to its target, then redistributes unused slots
- * to categories that have more items available. Preserves input order.
- *
- * @param opportunities - Pre-sorted opportunities (by confidence/recency)
- * @param viewerId - The viewing user's ID
- * @returns Composition-balanced subset
- */
-export function selectByComposition(opportunities, viewerId) {
-    const buckets = { connection: [], expired: [] };
-    for (const opp of opportunities) {
-        buckets[classifyOpportunity(opp, viewerId)].push(opp);
-    }
-    const targets = {
-        connection: RADAR_SOFT_TARGETS.connection,
-        expired: RADAR_SOFT_TARGETS.expired,
-    };
-    // First pass: fill each category up to its target.
-    const selected = {
-        connection: buckets.connection.slice(0, targets.connection),
-        expired: buckets.expired.slice(0, targets.expired),
-    };
-    // Second pass: redistribute unused slots, connection before expired.
-    let unusedSlots = (targets.connection + targets.expired)
-        - (selected.connection.length + selected.expired.length);
-    for (const category of ['connection', 'expired']) {
-        if (unusedSlots <= 0)
-            break;
-        const remaining = buckets[category].slice(selected[category].length);
-        const take = Math.min(remaining.length, unusedSlots);
-        selected[category].push(...remaining.slice(0, take));
-        unusedSlots -= take;
-    }
-    // Within each category, preserve original input order.
-    const indexMap = new Map(opportunities.map((opp, i) => [opp, i]));
-    const sortByOriginal = (a, b) => (indexMap.get(a) ?? 0) - (indexMap.get(b) ?? 0);
-    selected.connection.sort(sortByOriginal);
-    selected.expired.sort(sortByOriginal);
-    logger.info('Selected opportunities by composition', {
-        input: opportunities.length,
-        buckets: { connection: buckets.connection.length, expired: buckets.expired.length },
-        selected: { connection: selected.connection.length, expired: selected.expired.length },
-    });
-    return [...selected.connection, ...selected.expired];
-}
-/**
- * Deduplicate opportunities so each counterpart appears at most once.
- * Keeps the opportunity with the highest interpretation.confidence per
- * counterpart userId. On ties, the first encountered wins (stable).
- *
- * Counterpart = first actor whose userId !== viewerId.
- * Opportunities without a derivable counterpart pass through undeduped.
- *
- * @param opportunities - Pre-sorted opportunities (e.g. by confidence/recency)
- * @param viewerId - The viewing user's ID
- * @returns Deduped subset preserving original input order among winners
- */
-export function deduplicateByPerson(opportunities, viewerId) {
-    const bestByCounterpart = new Map();
-    const noCounterpart = [];
-    for (let i = 0; i < opportunities.length; i++) {
-        const opp = opportunities[i];
-        const counterpart = opp.actors.find((a) => a.userId !== viewerId);
-        if (!counterpart) {
-            noCounterpart.push({ opp, index: i });
-            continue;
-        }
-        const key = counterpart.userId;
-        const existing = bestByCounterpart.get(key);
-        if (!existing) {
-            bestByCounterpart.set(key, { opp, index: i });
-            continue;
-        }
-        const newConf = opp.interpretation?.confidence ?? -1;
-        const oldConf = existing.opp.interpretation?.confidence ?? -1;
-        if (newConf > oldConf) {
-            bestByCounterpart.set(key, { opp, index: i });
-        }
-    }
-    const all = [...bestByCounterpart.values(), ...noCounterpart];
-    all.sort((a, b) => a.index - b.index);
-    const result = all.map((entry) => entry.opp);
-    if (result.length < opportunities.length) {
-        dedupeByPersonLog.info('Deduped opportunities by person', {
-            input: opportunities.length,
-            output: result.length,
-        });
-    }
-    return result;
-}

package/dist/platform/database/capabilities.d.ts

@@ -51,9 +51,9 @@ export type IntentNetworkGraphDatabase = Pick<Database, 'getIntentForIndexing' |
  */
 export type NetworkMembershipGraphDatabase = Pick<Database, 'isNetworkMember' | 'isNetworkOwner' | 'getNetworkWithPermissions' | 'addMemberToNetwork' | 'removeMemberFromNetwork' | 'getNetworkMembersForMember'>;
 /**
- * Database interface for Radar Graph (opportunity radar view).
+ * Database interface for opportunity cards.
  * Load opportunities, enrich with profile/network, and support presenter context.
  *
  * Access layer: UserDatabase (own opportunities and profile)
  */
-export type RadarGraphDatabase = Pick<Database, 'getOpportunitiesForUser' | 'getOpportunity' | 'getProfile' | 'getActiveIntents' | 'getNetwork' | 'getUser'> & NegotiationContextDatabase;
+export type OpportunityCardsDatabase = Pick<Database, 'getOpportunitiesForUser' | 'getOpportunity' | 'getProfile' | 'getActiveIntents' | 'getNetwork' | 'getUser'> & NegotiationContextDatabase;

package/dist/platform/database/entities.d.ts

@@ -485,6 +485,6 @@ export interface OpportunityQueryOptions {
     actorUserId?: string;
     limit?: number;
     offset?: number;
-    /** When set, include draft opportunities for this chat session. When unset, exclude all draft opportunities (e.g. radar view, API). */
+    /** When set, include draft opportunities for this chat session. When unset, exclude all draft opportunities (e.g. opportunity cards, API). */
     conversationId?: string;
 }

package/package.json

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

package/dist/internal/opportunities/opportunity.feed-selection.d.ts

@@ -1,24 +0,0 @@
-import type { CompositeDatabase, Opportunity } from '../../platform/database.js';
-export interface OpportunityFeedSelectionInput {
-    reader: Pick<CompositeDatabase, 'getOpportunitiesForUser'>;
-    viewerId: string;
-    networkId?: string;
-    intentScope: {
-        scopeType?: 'intent';
-        scopeId?: string;
-    };
-    displayLimit: number;
-    warn: (message: string, data: Record<string, unknown>) => void;
-}
-export interface OpportunityFeedSelection {
-    opportunities: Opportunity[];
-    dedupedCount: number;
-    skippedIds: string[];
-    fetchedCount: number;
-}
-/**
- * Selects actionable opportunities for the chat/feed surface. The caller actor
- * check is deliberately the first post-read filter so non-actor rows cannot
- * affect selection or downstream profile/presentation reads.
- */
-export declare function selectOpportunityFeed(args: OpportunityFeedSelectionInput): Promise<OpportunityFeedSelection>;

package/dist/internal/opportunities/opportunity.feed-selection.js

@@ -1,40 +0,0 @@
-import { deduplicateByPerson, selectByComposition } from './opportunity.utils.js';
-const ACTIONABLE_FEED_STATUSES = ['pending'];
-const FEED_FETCH_LIMIT = 30;
-/**
- * Selects actionable opportunities for the chat/feed surface. The caller actor
- * check is deliberately the first post-read filter so non-actor rows cannot
- * affect selection or downstream profile/presentation reads.
- */
-export async function selectOpportunityFeed(args) {
-    const fetched = await args.reader.getOpportunitiesForUser(args.viewerId, {
-        networkId: args.networkId,
-        ...args.intentScope,
-        statuses: ACTIONABLE_FEED_STATUSES,
-        limit: FEED_FETCH_LIMIT,
-    });
-    const skippedIds = [];
-    const callerScoped = fetched.filter((opportunity) => {
-        if (opportunity.actors.some((actor) => actor.userId === args.viewerId))
-            return true;
-        args.warn('Opportunity feed: skipping opportunity where caller is not an actor', {
-            opportunityId: opportunity.id,
-            viewerId: args.viewerId,
-            actorUserIds: opportunity.actors
-                .map((actor) => actor.userId)
-                .filter((userId) => typeof userId === 'string'),
-        });
-        skippedIds.push(opportunity.id);
-        return false;
-    });
-    const deduped = deduplicateByPerson(callerScoped, args.viewerId);
-    const selected = deduped.length > 0
-        ? selectByComposition(deduped, args.viewerId)
-        : deduped;
-    return {
-        opportunities: selected.slice(0, args.displayLimit),
-        dedupedCount: deduped.length,
-        skippedIds,
-        fetchedCount: fetched.length,
-    };
-}