@indexnetwork/protocol 66.0.0-rc.641.1 → 66.0.0-rc.643.1

package/CHANGELOG.md

@@ -4,9 +4,15 @@
 
 ### Added
 
+- `OpportunityCard` gains `priorOpportunity` (an earlier accepted opportunity, or a pending one the viewer already said yes to) and `peerChat` (the viewer's existing direct chat with the counterpart), two separate facts. The card presenter gets the prior opportunity and no longer words a known contact as new. Types `PriorOpportunity` and `PeerChat` are exported.
+- `OpportunityCardsDatabase` and `OpportunityControllerDatabase` require `findPriorOpportunities(viewerId, peerIds, excludeOpportunityIds?)` and `findPeerChats(viewerId, peerIds)`, both batched and read-only.
 - `OpportunityDetection.source` gains `'introducer'`, stamped on opportunities a third party opens.
 - Protocol agent requests to OpenRouter carry `HTTP-Referer` and `X-Title` headers, so their spend is attributed apart from the hosted agent's, and a `trace` and `metadata` (`service: "protocol"`, `operation`) named by the agent key (for example `intentInferrer` or `chat`).
 
+### Fixed
+
+- `listOpportunityCards` no longer drops accepted opportunities that rank beyond the read window.
+
 ## 66.0.0
 
 ### Breaking changes

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, OpportunityCardsDatabase, 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, PriorOpportunity, PeerChat, 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";

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

@@ -3,7 +3,7 @@
  * 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 { Opportunity, OpportunityCardsDatabase, OpportunityStatus, PeerChat, PriorOpportunity } 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. */
@@ -36,6 +36,17 @@ export interface OpportunityCard {
      * empty because the presenter was skipped. Never cached.
      */
     presentationPending?: boolean;
+    /** An earlier opportunity with this person. Stamped live on every read, never cached. */
+    priorOpportunity?: PriorOpportunity | null;
+    /** The direct-message chat with this person. Stamped live on every read, never cached. */
+    peerChat?: PeerChat | null;
+    /** Which prior opportunity the cached copy was written against, so a changed one regenerates it. */
+    presentedPrior?: string | null;
+}
+/** What the viewer already has with one counterpart, besides the opportunity being shown. */
+interface PeerContext {
+    priorOpportunity: PriorOpportunity | null;
+    peerChat: PeerChat | null;
 }
 /** Everything card presentation reaches for. */
 export interface OpportunityCardsDeps {
@@ -49,7 +60,7 @@ export interface OpportunityCardsDeps {
  * @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; `noCache` skips the stored-card read.
+ * @param options - `intentId` focuses viewer context on one intent; `skeleton` skips the presenter; `noCache` skips the stored-card read; `peerContext` is the prior opportunity and chat when the caller already loaded them.
  * @returns The card, or null when the counterpart's name cannot be resolved.
  * @throws When the presenter fails.
  */
@@ -57,6 +68,7 @@ export declare function presentOpportunityCard(deps: OpportunityCardsDeps, oppor
     intentId?: string;
     skeleton?: boolean;
     noCache?: boolean;
+    peerContext?: PeerContext;
 }): Promise<OpportunityCard | null>;
 /**
  * List the viewer's opportunities in the given statuses as presented cards,
@@ -67,7 +79,7 @@ export declare function presentOpportunityCard(deps: OpportunityCardsDeps, oppor
  * one. 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.
+ * @param input - Viewer, statuses, optional network/intent scope, limit, cache bypass, skeleton mode. Accepted rows are read without the recency window.
  * @returns The cards and the number of opportunities selected.
  */
 export declare function listOpportunityCards(deps: OpportunityCardsDeps, input: {
@@ -82,3 +94,4 @@ export declare function listOpportunityCards(deps: OpportunityCardsDeps, input:
     cards: OpportunityCard[];
     totalOpportunities: number;
 }>;
+export {};

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

@@ -10,6 +10,7 @@ import { canUserSeeOpportunity } from './opportunity.utils.js';
 import { getPrimaryActionLabel, SECONDARY_ACTION_LABEL } from './opportunity.labels.js';
 const logger = protocolLogger('OpportunityCards');
 const PRESENTATION_CONCURRENCY = 50;
+const priorKey = (prior) => prior ? `${prior.opportunityId}:${prior.status}` : null;
 const ROLE_PRIORITY = new Map([
     ['patient', 0],
     ['party', 1],
@@ -50,13 +51,32 @@ function counterpartSlotRank(opportunity, viewerId) {
 function stampViewerCommitted(card, viewerCommitted) {
     return { ...card, viewerCommitted };
 }
+function stampPeerContext(card, context) {
+    return { ...card, ...context };
+}
+/** One batched read of prior opportunities and chats for the counterparts of `opportunities`. */
+async function loadPeerContext(database, viewerId, opportunities) {
+    const peerOf = new Map(opportunities.map((opp) => [opp.id, pickDisplayCounterpartActor(opp, viewerId)?.userId]));
+    const peerIds = [...new Set([...peerOf.values()].filter((id) => !!id))];
+    const [priors, chats] = await Promise.all([
+        database.findPriorOpportunities(viewerId, peerIds, opportunities.map((opp) => opp.id)),
+        database.findPeerChats(viewerId, peerIds),
+    ]).catch((error) => {
+        logger.warn('peer context read failed, presenting without it', { error });
+        return [new Map(), new Map()];
+    });
+    return new Map(opportunities.map((opp) => {
+        const peerId = peerOf.get(opp.id);
+        return [opp.id, { priorOpportunity: (peerId && priors.get(peerId)) || null, peerChat: (peerId && chats.get(peerId)) || null }];
+    }));
+}
 /**
  * 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; `noCache` skips the stored-card read.
+ * @param options - `intentId` focuses viewer context on one intent; `skeleton` skips the presenter; `noCache` skips the stored-card read; `peerContext` is the prior opportunity and chat when the caller already loaded them.
  * @returns The card, or null when the counterpart's name cannot be resolved.
  * @throws When the presenter fails.
  */
@@ -67,13 +87,16 @@ export async function presentOpportunityCard(deps, opportunity, viewerId, option
     if (!counterpart)
         return null;
     const viewerCommitted = viewerHasCommitted(opportunity, viewerId);
+    const peerContext = options.peerContext
+        ?? (await loadPeerContext(database, viewerId, [opportunity])).get(opportunity.id);
     const cacheable = opportunity.status !== 'negotiating';
     const cacheKey = buildOpportunityCardCacheKey(opportunity.id, viewerId, options.intentId);
     if (cacheable && !options.skeleton && !options.noCache) {
         try {
             const hit = await deps.cache.get(cacheKey);
-            if (hit)
-                return stampViewerCommitted({ ...hit, status: opportunity.status }, viewerCommitted);
+            if (hit && (hit.presentedPrior ?? null) === priorKey(peerContext.priorOpportunity)) {
+                return stampPeerContext(stampViewerCommitted({ ...hit, status: opportunity.status }, viewerCommitted), peerContext);
+            }
         }
         catch (error) {
             logger.warn('card cache read failed, presenting', { opportunityId: opportunity.id, error });
@@ -99,7 +122,7 @@ export async function presentOpportunityCard(deps, opportunity, viewerId, option
         viewerRole,
     };
     if (options.skeleton) {
-        return stampViewerCommitted({ ...identity, mainText: '', cta: '', mutualIntentsLabel: 'Shared interests', presentationPending: true }, viewerCommitted);
+        return stampPeerContext(stampViewerCommitted({ ...identity, mainText: '', cta: '', mutualIntentsLabel: 'Shared interests', presentationPending: true }, viewerCommitted), peerContext);
     }
     const [context, negotiationContext] = await Promise.all([
         gatherPresenterContext(database, opportunity, viewerId, counterpart.userId, options.intentId),
@@ -109,6 +132,7 @@ export async function presentOpportunityCard(deps, opportunity, viewerId, option
         ...context,
         opportunityStatus: opportunity.status,
         ...(negotiationContext ? { negotiationContext } : {}),
+        ...(peerContext.priorOpportunity ? { priorOpportunity: peerContext.priorOpportunity } : {}),
     });
     const card = stampViewerCommitted({
         ...identity,
@@ -117,13 +141,14 @@ export async function presentOpportunityCard(deps, opportunity, viewerId, option
         headline: presentation.headline,
         mutualIntentsLabel: presentation.mutualIntentsLabel,
         narratorChip: { name: 'Index', text: presentation.narratorRemark },
+        presentedPrior: priorKey(peerContext.priorOpportunity),
     }, viewerCommitted);
     if (cacheable) {
         await deps.cache.set(cacheKey, card).catch((error) => {
             logger.warn('card cache write failed', { opportunityId: opportunity.id, error });
         });
     }
-    return card;
+    return stampPeerContext(card, peerContext);
 }
 /**
  * List the viewer's opportunities in the given statuses as presented cards,
@@ -134,17 +159,31 @@ export async function presentOpportunityCard(deps, opportunity, viewerId, option
  * one. 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.
+ * @param input - Viewer, statuses, optional network/intent scope, limit, cache bypass, skeleton mode. Accepted rows are read without the recency window.
  * @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,
+    const scope = {
         ...(input.networkId ? { networkId: input.networkId } : {}),
         ...(intentId ? { scopeType: 'intent', scopeId: intentId } : {}),
-    });
+    };
+    // Accepted rows are few and always win a person's slot, so they are read apart,
+    // not left to fall outside the newest-rows window the other statuses share.
+    const others = input.statuses.filter((status) => status !== 'accepted');
+    const [accepted, rest] = await Promise.all([
+        input.statuses.includes('accepted')
+            ? deps.database.getOpportunitiesForUser(viewerId, { statuses: ['accepted'], ...scope })
+            : [],
+        others.length
+            ? deps.database.getOpportunitiesForUser(viewerId, {
+                limit: Math.min(150, Math.max(50, input.limit * 3)),
+                statuses: others,
+                ...scope,
+            })
+            : [],
+    ]);
+    const raw = [...accepted, ...rest];
     const requested = new Set(input.statuses);
     const visible = raw
         .filter((opp) => requested.has(opp.status) && canUserSeeOpportunity(opp.actors, opp.status, viewerId))
@@ -163,6 +202,7 @@ export async function listOpportunityCards(deps, input) {
             seen.add(id);
         return true;
     }).slice(0, input.limit);
+    const peerContexts = await loadPeerContext(deps.database, viewerId, opportunities);
     const cacheable = (opp) => opp.status !== 'negotiating';
     const keyFor = (opp) => buildOpportunityCardCacheKey(opp.id, viewerId, intentId);
     const cacheableOpps = input.noCache ? [] : opportunities.filter(cacheable);
@@ -172,8 +212,10 @@ export async function listOpportunityCards(deps, input) {
             const hits = await deps.cache.mget(cacheableOpps.map(keyFor));
             cacheableOpps.forEach((opp, i) => {
                 const hit = hits[i];
-                if (hit)
-                    cached.set(opp.id, stampViewerCommitted({ ...hit, status: opp.status }, viewerHasCommitted(opp, viewerId)));
+                const peerContext = peerContexts.get(opp.id);
+                if (hit && (hit.presentedPrior ?? null) === priorKey(peerContext.priorOpportunity)) {
+                    cached.set(opp.id, stampPeerContext(stampViewerCommitted({ ...hit, status: opp.status }, viewerHasCommitted(opp, viewerId)), peerContext));
+                }
             });
         }
         catch (error) {
@@ -192,12 +234,8 @@ export async function listOpportunityCards(deps, input) {
                     intentId,
                     skeleton: input.skeleton,
                     noCache: input.noCache,
+                    peerContext: peerContexts.get(opp.id),
                 });
-                if (card && !card.presentationPending && cacheable(opp)) {
-                    await deps.cache.set(keyFor(opp), card).catch((error) => {
-                        logger.warn('card cache write failed', { opportunityId: opp.id, error });
-                    });
-                }
                 return card;
             }
             catch (error) {

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

@@ -10,7 +10,7 @@
  *   2. OpportunityPresenter (LLM card and chat copy)
  */
 import { z } from "zod";
-import type { Opportunity } from "../../platform/database.js";
+import type { Opportunity, PriorOpportunity } from "../../platform/database.js";
 import type { CompositeDatabase } from "../../platform/database.js";
 import type { NegotiationContext } from "./negotiation-context.loader.js";
 export interface UserInfo {
@@ -63,6 +63,8 @@ export interface CardPresenterInput extends PresenterInput {
      * transcript and outcome ground the LLM's explanation.
      */
     negotiationContext?: NegotiationContext;
+    /** An earlier opportunity with the same person: already connected, or the viewer already said yes. */
+    priorOpportunity?: Pick<PriorOpportunity, "status" | "at" | "topic">;
 }
 /** LLM-generated fields for card presentation (buttons are hardcoded by callers, not LLM-generated). */
 export declare const CardLLMSchema: z.ZodObject<{

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

@@ -242,8 +242,15 @@ Produce headline, personalizedSummary (2-3 sentences in "you" language), suggest
         const negotiationDirective = negotiationBlock
             ? `\nIMPORTANT: This opportunity surfaced because the agents negotiated and converged. Your personalizedSummary MUST reference at least one specific intent from the NEGOTIATION CONTEXT block below — what concern was raised, what was confirmed, what the agents agreed on. It must communicate *why this specific match* surfaced now (the negotiation that led to it), not a generic skill-complementarity line. Do not produce the generic summary every card looked like before this negotiation happened.\n`
             : "";
+        const prior = input.priorOpportunity;
+        const priorDate = prior ? new Date(prior.at).toLocaleDateString("en-US", { month: "short", day: "numeric", timeZone: "UTC" }) : "";
+        const priorBlock = prior
+            ? `\nEARLIER CONTACT: ${prior.status === "accepted"
+                ? `The viewer and the other party already connected on ${priorDate}${prior.topic ? `, about: ${prior.topic}` : ""}. Say so plainly, then say what is new here.`
+                : `The viewer already said yes to the other party on ${priorDate}${prior.topic ? `, about: ${prior.topic}` : ""}, and they have not answered. They are not connected yet, so do not say they are. Say the viewer already said yes, then what is new here.`} Never use the words intro, intent or opportunity.\n`
+            : "";
         const humanContent = `
-${negotiationBlock}${negotiationDirective}
+${negotiationBlock}${negotiationDirective}${priorBlock}
 VIEWER (the person seeing this opportunity):
 ${input.viewerContext}
 

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

@@ -19,7 +19,7 @@ export type CompositeDatabase = Pick<Database, 'getProfile' | 'openCounterpartie
  * Access layer: SystemDatabase (cross-user opportunity operations)
  */
 export type OpportunityDatabase = Pick<Database, 'getProfile' | 'getOpportunity' | 'getOpportunitiesForUser' | 'getNetwork' | 'getUser' | 'isNetworkMember' | 'isNetworkOwner' | 'getOrCreateDM' | 'updateOpportunityStatus'>;
-export type OpportunityControllerDatabase = Pick<Database, 'getOpportunity' | 'getOpportunitiesByIds' | 'findEnrichedReplacementOpportunities' | 'getOpportunitiesForUser' | 'getOpportunitiesForNetwork' | 'resolveOpportunityId' | 'updateOpportunityStatus' | 'createOpportunity' | 'createOpportunityAndExpireIds' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'isNetworkOwner' | 'isNetworkMember' | 'getUser' | 'getNetwork' | 'getNetworkMemberships' | 'getProfile' | 'getActiveIntents' | 'getOrCreateDM' | 'unhideConversation'>;
+export type OpportunityControllerDatabase = Pick<Database, 'getOpportunity' | 'getOpportunitiesByIds' | 'findEnrichedReplacementOpportunities' | 'getOpportunitiesForUser' | 'getOpportunitiesForNetwork' | 'resolveOpportunityId' | 'updateOpportunityStatus' | 'createOpportunity' | 'createOpportunityAndExpireIds' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'isNetworkOwner' | 'isNetworkMember' | 'getUser' | 'getNetwork' | 'getNetworkMemberships' | 'getProfile' | 'getActiveIntents' | 'getOrCreateDM' | 'unhideConversation' | 'findPriorOpportunities' | 'findPeerChats'>;
 /**
  * Database interface narrowed for Intent Graph operations.
  * Provides state population (getActiveIntents), action execution (create/update/archive),
@@ -56,4 +56,4 @@ export type NetworkMembershipGraphDatabase = Pick<Database, 'isNetworkMember' |
  *
  * Access layer: UserDatabase (own opportunities and profile)
  */
-export type OpportunityCardsDatabase = Pick<Database, 'getOpportunitiesForUser' | 'getOpportunity' | 'getProfile' | 'getActiveIntents' | 'getNetwork' | 'getUser'> & NegotiationContextDatabase;
+export type OpportunityCardsDatabase = Pick<Database, 'getOpportunitiesForUser' | 'getOpportunity' | 'getProfile' | 'getActiveIntents' | 'getNetwork' | 'getUser' | 'findPriorOpportunities' | 'findPeerChats'> & NegotiationContextDatabase;

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

@@ -420,6 +420,26 @@ export interface UpdateNetworkSettingsData {
     joinPolicy?: 'anyone' | 'invite_only';
 }
 export type OpportunityStatus = 'negotiating' | 'pending' | 'accepted' | 'rejected' | 'expired';
+/**
+ * The strongest other opportunity between the viewer and one peer: an accepted
+ * one, else a pending one the viewer committed to. `topic` is what its
+ * negotiation settled on, truncated; never a transcript.
+ */
+export interface PriorOpportunity {
+    opportunityId: string;
+    status: 'accepted' | 'pending';
+    /** When it became accepted, or when the viewer said yes (ISO). */
+    at: string;
+    topic?: string;
+}
+/** The direct-message chat between the viewer and one peer. Never carries message text. */
+export interface PeerChat {
+    conversationId: string;
+    lastMessage?: {
+        fromUserId: string;
+        at: string;
+    };
+}
 /**
  * Minimal opportunity lifecycle evidence used to narrate an agent negotiation.
  * `acceptedByOwner` is true only when the authenticated owner is the persisted

package/dist/platform/database/member-queries.d.ts

@@ -1,6 +1,7 @@
 /**
  * Database operations for user contexts.
  */
+import type { PeerChat } from './entities.js';
 /** User-context operations. */
 export interface DatabaseMemberQueries {
     /**
@@ -13,6 +14,12 @@ export interface DatabaseMemberQueries {
     getOrCreateDM(userA: string, userB: string, participantType?: 'user' | 'agent'): Promise<{
         id: string;
     }>;
+    /**
+     * Read-only lookup of the DM chat between the viewer and each peer, with the
+     * latest message's sender and time. Never creates a conversation. Peers with
+     * no chat are absent.
+     */
+    findPeerChats(viewerId: string, peerIds: string[]): Promise<Map<string, PeerChat>>;
     /**
      * Clears hiddenAt for a user on a conversation, making it visible in their
      * conversation list again. Called by startChat when reusing an existing DM

package/dist/platform/database/opportunity-queries.d.ts

@@ -2,7 +2,7 @@ import type { NegotiationOpening, NegotiationOpeningDecision } from '../../proto
 /**
  * Database operations for the opportunity lifecycle.
  */
-import type { CreateIntentCounterpartyData, CreateOpportunityData, IntentScopedOpportunityPersistenceResult, OpenedNegotiation, Opportunity, OpportunityActor, OpportunityNetworkEligibility, OpportunityQueryOptions, OpportunityStatus } from './entities.js';
+import type { CreateIntentCounterpartyData, CreateOpportunityData, IntentScopedOpportunityPersistenceResult, OpenedNegotiation, Opportunity, OpportunityActor, OpportunityNetworkEligibility, OpportunityQueryOptions, OpportunityStatus, PriorOpportunity } from './entities.js';
 /** Opportunity persistence operations. */
 export interface DatabaseOpportunityQueries {
     /**
@@ -160,6 +160,16 @@ export interface DatabaseOpportunityQueries {
         statuses?: OpportunityStatus[];
         excludeStatuses?: OpportunityStatus[];
     }): Promise<Opportunity[]>;
+    /**
+     * For each peer, the strongest other opportunity with the viewer: an accepted
+     * one, else a pending one the viewer committed to. Peers with none are absent.
+     *
+     * @param viewerId - The viewing user
+     * @param peerIds - Counterpart user IDs
+     * @param excludeOpportunityIds - Opportunities being rendered, so one is never its own prior
+     * @returns Map of peer user ID to their prior opportunity
+     */
+    findPriorOpportunities(viewerId: string, peerIds: string[], excludeOpportunityIds?: string[]): Promise<Map<string, PriorOpportunity>>;
     /**
      * IND-567 Rejection cool-down: returns the subset of `candidateUserIds` that
      * have at least one non-draft opportunity with `discovererId` whose `updatedAt`

package/package.json

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