@indexnetwork/protocol 8.1.1-rc.422.1 → 8.3.0-rc.424.1

package/dist/opportunity/discovery.env.js

@@ -0,0 +1,79 @@
+/**
+ * Centralized accessors for discovery match-type environment variables.
+ *
+ *   DISCOVERY_ALLOWED_TYPES   CSV of `intent`, `profile` (default: both).
+ *                             Master gate for which data types may participate
+ *                             in opportunity matching. `profile` is an umbrella
+ *                             whose representation is selected by
+ *                             DISCOVERY_PROFILE_SOURCE. Unknown tokens warn once
+ *                             and are ignored; if no valid tokens remain, falls
+ *                             back to both-allowed with a warning (a typo must
+ *                             never disable all discovery).
+ *   DISCOVERY_PROFILE_SOURCE  `premise` (default, heavyweight: atomic premises
+ *                             as profile corpus + premise-to-premise) or
+ *                             `user_context` (lightweight: synthesized context
+ *                             paragraphs as profile corpus + context-to-context).
+ *                             Unknown values warn once and fall back to `premise`.
+ *
+ * All reads go through this module — do not read these variables via
+ * `process.env` elsewhere. Values are read on every call (no caching) so
+ * tests and long-lived processes observe changes.
+ */
+import { protocolLogger } from '../shared/observability/protocol.logger.js';
+const envLog = protocolLogger('Discovery:env');
+const VALID_TOKENS = new Set(['intent', 'profile']);
+const BOTH = new Set(['intent', 'profile']);
+/** Tokens/values already warned about (warn-once per process). */
+const warned = new Set();
+/** Test hook: clear warn-once state so each test observes warnings. */
+export function resetDiscoveryEnvWarningsForTests() {
+    warned.clear();
+}
+function warnOnce(key, message) {
+    if (warned.has(key))
+        return;
+    warned.add(key);
+    envLog.warn(message);
+}
+/** Current DISCOVERY_ALLOWED_TYPES set (default: intent + profile). */
+export function discoveryAllowedTypes() {
+    const raw = process.env.DISCOVERY_ALLOWED_TYPES;
+    if (raw === undefined || raw.trim() === '')
+        return BOTH;
+    const parsed = new Set();
+    for (const token of raw.split(',')) {
+        const t = token.trim().toLowerCase();
+        if (!t)
+            continue;
+        if (VALID_TOKENS.has(t)) {
+            parsed.add(t);
+        }
+        else {
+            warnOnce(`token:${t}`, `DISCOVERY_ALLOWED_TYPES: ignoring unknown token "${t}" (valid: intent, profile)`);
+        }
+    }
+    if (parsed.size === 0) {
+        warnOnce('fallback', `DISCOVERY_ALLOWED_TYPES="${raw}" has no valid tokens; falling back to intent,profile`);
+        return BOTH;
+    }
+    return parsed;
+}
+/** True when intents may participate in matching (source or candidate). */
+export function discoveryIntentMatchingEnabled() {
+    return discoveryAllowedTypes().has('intent');
+}
+/** True when profile data (premises or user_contexts) may participate. */
+export function discoveryProfileMatchingEnabled() {
+    return discoveryAllowedTypes().has('profile');
+}
+/** Current DISCOVERY_PROFILE_SOURCE (default: premise). */
+export function discoveryProfileSource() {
+    const raw = process.env.DISCOVERY_PROFILE_SOURCE;
+    if (raw === undefined || raw.trim() === '')
+        return 'premise';
+    const v = raw.trim().toLowerCase();
+    if (v === 'premise' || v === 'user_context')
+        return v;
+    warnOnce(`source:${v}`, `DISCOVERY_PROFILE_SOURCE: unknown value "${raw}"; falling back to "premise" (valid: premise, user_context)`);
+    return 'premise';
+}

package/dist/opportunity/domain/opportunity.evidence.d.ts

@@ -3,12 +3,13 @@ export interface EvidenceCandidateInput {
     networkId: string;
     similarity: number;
     lens: string;
-    discoverySource?: 'query' | 'premise-similarity' | 'context-to-intent';
+    discoverySource?: 'query' | 'premise-similarity' | 'context-to-intent' | 'context-similarity';
     matchedStrategies?: string[];
     sourcePremiseId?: string;
     candidatePremiseId?: string;
     candidateIntentId?: string;
     sourceContextId?: string;
+    candidateContextId?: string;
     candidatePayload?: string;
     candidateSummary?: string;
 }

package/dist/opportunity/domain/opportunity.evidence.js

@@ -11,6 +11,7 @@ export function buildCandidateEvidence(candidate) {
         candidatePremiseId: candidate.candidatePremiseId,
         candidateIntentId: candidate.candidateIntentId,
         sourceContextId: candidate.sourceContextId,
+        candidateContextId: candidate.candidateContextId,
         payload: candidate.candidatePayload,
         summary: candidate.candidateSummary,
         assertionText: candidate.candidatePremiseId ? candidate.candidatePayload : undefined,
@@ -29,6 +30,7 @@ export function mergeOpportunityEvidence(...groups) {
             evidence.candidatePremiseId ?? '',
             evidence.candidateIntentId ?? '',
             evidence.sourceContextId ?? '',
+            evidence.candidateContextId ?? '',
             evidence.lens ?? '',
         ].join('|');
         const existing = byKey.get(key);
@@ -52,6 +54,7 @@ export function renderOpportunityEvidenceForPrompt(evidence) {
             item.candidatePremiseId ? `candidatePremise=${item.candidatePremiseId}` : undefined,
             item.candidateIntentId ? `candidateIntent=${item.candidateIntentId}` : undefined,
             item.sourceContextId ? `sourceContext=${item.sourceContextId}` : undefined,
+            item.candidateContextId ? `candidateContext=${item.candidateContextId}` : undefined,
             item.matchedStrategies?.length ? `strategies=${item.matchedStrategies.join(',')}` : undefined,
         ].filter(Boolean).join(', ');
         const text = item.summary ?? item.payload ?? item.assertionText ?? '';
@@ -59,19 +62,25 @@ export function renderOpportunityEvidenceForPrompt(evidence) {
         // so it does not treat a high RAG score as domain confirmation.
         // (text should be populated by Fix A; this fallback fires if the DB fetch
         //  failed or the adapter omitted getPremise).
-        const domainCaution = item.kind === 'query_premise' && !text
+        const domainCaution = (item.kind === 'query_premise' && !text)
             ? ' [premise text unavailable — do NOT infer domain match from RAG score alone; verify domain alignment from profile]'
-            : '';
+            : (item.kind === 'query_context' && !text)
+                ? ' [context text unavailable — do NOT infer domain match from RAG score alone; verify domain alignment from profile]'
+                : '';
         return `    - ${item.kind} on ${item.networkId} via ${item.lens ?? 'unknown'} score=${item.score?.toFixed(3) ?? '—'}${refs ? ` (${refs})` : ''}${text ? `: ${text}` : ''}${domainCaution}`;
     }).join('\n');
 }
 function resolveEvidenceKind(candidate) {
     if (candidate.discoverySource === 'premise-similarity')
         return 'premise_similarity';
+    if (candidate.discoverySource === 'context-similarity')
+        return 'context_similarity';
     if (candidate.discoverySource === 'context-to-intent')
         return 'context_to_intent';
     if (candidate.candidatePremiseId)
         return 'query_premise';
+    if (candidate.candidateContextId)
+        return 'query_context';
     if (candidate.candidateIntentId)
         return 'query_intent';
     return 'profile';

package/dist/opportunity/domain/opportunity.state.d.ts

@@ -51,14 +51,16 @@ export interface CandidateMatch {
     candidatePremiseId?: Id<'premises'>;
     /** Source context that produced this candidate (set when discoverySource is 'context-to-intent'). */
     sourceContextId?: string;
+    /** Candidate context that matched this candidate (set for user_context-based matches). */
+    candidateContextId?: string;
     networkId: Id<'networks'>;
     similarity: number;
     /** Free-text lens label that produced this match. */
     lens: string;
     candidatePayload: string;
     candidateSummary?: string;
-    /** How this candidate was found: 'query' (HyDE from search text), 'premise-similarity', or 'context-to-intent'. */
-    discoverySource?: 'query' | 'premise-similarity' | 'context-to-intent';
+    /** How this candidate was found: 'query' (HyDE from search text), 'premise-similarity', 'context-to-intent', or 'context-similarity'. */
+    discoverySource?: 'query' | 'premise-similarity' | 'context-to-intent' | 'context-similarity';
     /** Which discovery strategies found this candidate (set by mergeStrategyCandidates). */
     matchedStrategies?: string[];
     /** Typed evidence that explains why this candidate entered evaluation. */

package/dist/opportunity/public/index.d.ts

@@ -24,6 +24,8 @@ export { buildDiscoverySummary, toDiscoveryNegotiation, } from "../domain/negoti
 export type { NegotiationResolution } from "../domain/negotiation-summary.builder.js";
 export type { PoolCandidate, DiscriminatorMiningInput, MinedDiscriminator, ScoredDiscriminator, DiscriminatorShadowResult, } from "../discriminator/discriminator.types.js";
 export { poolQuestionsMiningMode, poolQuestionsMode, poolQuestionsPushMode, poolQuestionsStampNewborn, POOL_DISCRIMINATOR_MIN_POOL_SIZE, POOL_DISCRIMINATOR_MAX_CANDIDATES, POOL_DISCRIMINATOR_MAX_PUBLIC_CONTEXT_CHARS, POOL_QUESTION_MIN_VOI, POOL_QUESTION_MAX_PENDING_PER_INTENT, poolQuestionsRanking, POOL_RERUN_DEBOUNCE_MS, poolQuestionsVisitTrigger, POOL_VISIT_MINING_DEBOUNCE_MS, } from "../discriminator/discriminator.env.js";
+export { discoveryAllowedTypes, discoveryIntentMatchingEnabled, discoveryProfileMatchingEnabled, discoveryProfileSource, resetDiscoveryEnvWarningsForTests, } from "../discovery.env.js";
+export type { DiscoveryMatchType, DiscoveryProfileSource, } from "../discovery.env.js";
 export { buildPoolAdjustment, planPoolAdjustments, mergePoolAdjustment, } from "../discriminator/discriminator.adjustments.js";
 export type { PoolAdjustment, PoolAdjustmentSignal, } from "../discriminator/discriminator.adjustments.js";
 export { synthesizePoolQuestion, selectQuestionDiscriminators, toQuestionDiscriminator, BOTH_MATTER_LABEL, } from "../discriminator/discriminator.question.js";

package/dist/opportunity/public/index.js

@@ -21,6 +21,8 @@ export { safeFallbackSummary, SAFE_FALLBACK_MAX_CHARS, DEFAULT_EMPTY_FALLBACK_TE
 export { OPPORTUNITY_PRESENTATION_CACHE_VERSION, buildHomeCardPresentationCacheKey, buildHomeCategoryPresentationCacheKey, buildDeliveryCardPresentationCacheKey, buildApiChatCardPresentationCacheKey, } from "../domain/opportunity.presentation-cache.js";
 export { buildDiscoverySummary, toDiscoveryNegotiation, } from "../domain/negotiation-summary.builder.js";
 export { poolQuestionsMiningMode, poolQuestionsMode, poolQuestionsPushMode, poolQuestionsStampNewborn, POOL_DISCRIMINATOR_MIN_POOL_SIZE, POOL_DISCRIMINATOR_MAX_CANDIDATES, POOL_DISCRIMINATOR_MAX_PUBLIC_CONTEXT_CHARS, POOL_QUESTION_MIN_VOI, POOL_QUESTION_MAX_PENDING_PER_INTENT, poolQuestionsRanking, POOL_RERUN_DEBOUNCE_MS, poolQuestionsVisitTrigger, POOL_VISIT_MINING_DEBOUNCE_MS, } from "../discriminator/discriminator.env.js";
+// discovery env accessors
+export { discoveryAllowedTypes, discoveryIntentMatchingEnabled, discoveryProfileMatchingEnabled, discoveryProfileSource, resetDiscoveryEnvWarningsForTests, } from "../discovery.env.js";
 export { buildPoolAdjustment, planPoolAdjustments, mergePoolAdjustment, } from "../discriminator/discriminator.adjustments.js";
 export { synthesizePoolQuestion, selectQuestionDiscriminators, toQuestionDiscriminator, BOTH_MATTER_LABEL, } from "../discriminator/discriminator.question.js";
 export { poolQuestionCycleKey, buildPoolQuestionPushMessage, } from "../discriminator/discriminator.push.js";

package/dist/shared/agent/activity-projection.d.ts

@@ -86,11 +86,11 @@ export declare const McpActivityCallerSchema: z.ZodObject<{
     /** A network agent's bound community; always null for humans. */
     networkScopeId: z.ZodNullable<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    kind: "human" | "agent";
+    kind: "agent" | "human";
     permissions: string[];
     networkScopeId: string | null;
 }, {
-    kind: "human" | "agent";
+    kind: "agent" | "human";
     permissions: string[];
     networkScopeId: string | null;
 }>;

package/dist/shared/agent/model.config.d.ts

@@ -31,7 +31,8 @@ export interface ModelConfig {
     /** Override the chat reasoning effort. Falls back to CHAT_REASONING_EFFORT env var. */
     chatReasoningEffort?: 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
 }
-declare function getModelConfig(config?: ModelConfig): {
+/** Per-agent model settings before any eval-only override is applied. */
+declare function getBaseModelConfig(config?: ModelConfig): {
     readonly intentInferrer: {
         readonly model: "google/gemini-2.5-flash";
     };
@@ -172,7 +173,7 @@ declare function getModelConfig(config?: ModelConfig): {
     };
 };
 /** Key identifying one of the per-agent model configurations. */
-export type ModelAgent = keyof ReturnType<typeof getModelConfig>;
+export type ModelAgent = keyof ReturnType<typeof getBaseModelConfig>;
 /**
  * Returns the model name string for the given agent key.
  * @param agent - Key from MODEL_CONFIG identifying which agent's settings to use.

package/dist/shared/agent/model.config.js

@@ -1,5 +1,49 @@
 import { ChatOpenAI } from "@langchain/openai";
-function getModelConfig(config) {
+/**
+ * Eval-only per-agent model overrides, e.g.
+ * `EVAL_MODEL_OVERRIDES={"opportunityEvaluator":"anthropic/claude-sonnet-4"}`.
+ *
+ * Read on every call (no caching) to match the surrounding env convention, and
+ * ignored entirely in production so a deployed process can never be repointed at
+ * another model by an environment variable. A malformed value or an unknown agent
+ * key throws: a typo must not silently produce a run that measured the default.
+ */
+function readModelOverrides(agentKeys) {
+    if (process.env.NODE_ENV === "production")
+        return {};
+    const raw = process.env.EVAL_MODEL_OVERRIDES?.trim();
+    if (!raw)
+        return {};
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        // `new Error(msg, { cause })` needs lib ES2022; this package targets ES2020,
+        // so the cause is attached after construction (same pattern as elsewhere in src).
+        const wrapped = new Error(`EVAL_MODEL_OVERRIDES is not valid JSON: ${raw}`);
+        wrapped.cause = err;
+        throw wrapped;
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        throw new Error("EVAL_MODEL_OVERRIDES must be a JSON object of agent -> model id");
+    }
+    const overrides = {};
+    for (const [agent, model] of Object.entries(parsed)) {
+        if (!agentKeys.includes(agent)) {
+            throw new Error(`EVAL_MODEL_OVERRIDES names an unknown agent "${agent}". Known agents: ${agentKeys.join(", ")}`);
+        }
+        if (typeof model !== "string" || model.trim() === "") {
+            throw new Error(`EVAL_MODEL_OVERRIDES value for "${agent}" must be a non-empty model id string`);
+        }
+        // Store trimmed: surrounding whitespace in the JSON value would otherwise be
+        // sent verbatim to OpenRouter as part of the model id.
+        overrides[agent] = model.trim();
+    }
+    return overrides;
+}
+/** Per-agent model settings before any eval-only override is applied. */
+function getBaseModelConfig(config) {
     return {
         intentInferrer: { model: "google/gemini-2.5-flash" },
         intentIndexer: { model: "google/gemini-2.5-flash" },
@@ -43,6 +87,22 @@ function getModelConfig(config) {
         },
     };
 }
+/**
+ * Per-agent model settings, with `EVAL_MODEL_OVERRIDES` applied when present.
+ * Only the model id is overridable: temperature, token limits and reasoning
+ * effort stay fixed so an eval measures a model swap and nothing else.
+ */
+function getModelConfig(config) {
+    const base = getBaseModelConfig(config);
+    const overrides = readModelOverrides(Object.keys(base));
+    if (Object.keys(overrides).length === 0)
+        return base;
+    const merged = Object.fromEntries(Object.entries(base).map(([agent, settings]) => {
+        const model = overrides[agent];
+        return [agent, model ? { ...settings, model } : settings];
+    }));
+    return merged;
+}
 /**
  * Returns the model name string for the given agent key.
  * @param agent - Key from MODEL_CONFIG identifying which agent's settings to use.

package/dist/shared/interfaces/database.interface.d.ts

@@ -1482,6 +1482,25 @@ export interface Database {
         assertionText: string;
         similarity: number;
     }>>;
+    /**
+     * Cosine similarity search against user_context embeddings, scoped to shared networks.
+     * Matches only per-network context rows (the global networkId-null row is never a
+     * candidate), excluding the discovering user. Optional — lightweight-mode
+     * context-to-context discovery no-ops when the adapter omits it.
+     */
+    searchUserContextsBySimilarity?(params: {
+        embedding: number[];
+        networkIds: string[];
+        excludeUserId: string;
+        limit: number;
+        minScore?: number;
+    }): Promise<Array<{
+        contextId: string;
+        userId: string;
+        networkId: string;
+        text: string;
+        similarity: number;
+    }>>;
     /**
      * Batched version of premise similarity search. Executes one bounded DB call
      * for all selected source premises instead of one query per source premise.
@@ -1911,7 +1930,7 @@ export type PremiseGraphDatabase = Pick<Database, 'createPremise' | 'getPremise'
  *
  * Access layer: Both UserDatabase + SystemDatabase (orchestrates all operations)
  */
-export type ChatGraphCompositeDatabase = Pick<Database, 'getProfile' | 'getActiveIntents' | 'getActiveIntentsAcrossIndexes' | 'getIntentsInIndexForMember' | 'getUser' | 'updateUser' | 'getUserSocials' | 'setUserSocials' | 'saveProfile' | 'softDeleteGhost' | 'createIntent' | 'updateIntent' | 'archiveIntent' | 'createOpportunity' | 'createOpportunityIfNetworkEligible' | 'createOpportunityAndExpireIdsIfNetworkEligible' | 'persistIntentScopedOpportunityIfNetworkEligible' | 'updateOpportunityStatusIfNetworkEligible' | 'getOpportunity' | 'getOpportunitiesByIds' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'getOpportunitiesForUser' | 'updateOpportunityStatus' | 'compensateTasklessNegotiatingOpportunity' | 'updateOpportunityActorApproval' | 'stampOpportunityActorAction' | 'getOrCreateDM' | 'getHydeDocument' | 'getHydeDocumentsForSource' | 'saveHydeDocument' | 'getIntent' | 'getPublicIndexesNotJoined' | 'getUserIndexIds' | 'getAssignmentNetworkMembershipsForUser' | 'getAssignmentNetworkIdsForUser' | 'getNetworkMemberships' | 'getNetworkMembership' | 'getActiveNetworkMembershipPairs' | 'getNetwork' | 'getNetworkWithPermissions' | 'getIntentForIndexing' | 'getNetworkMemberContext' | 'getNetworkAssignmentContext' | 'isIntentAssignedToIndex' | 'assignIntentToNetwork' | 'assignIntentToNetworkIfMember' | 'unassignIntentFromIndex' | 'getNetworkIdsForIntent' | 'getIntentIndexScores' | 'getPersonalIndexesForContact' | 'getOwnedIndexes' | 'isIndexOwner' | 'isNetworkMember' | 'getNetworkMembersForOwner' | 'getNetworkMembersForMember' | 'getMembersFromUserIndexes' | 'getNetworkIntentsForOwner' | 'getNetworkIntentsForMember' | 'updateIndexSettings' | 'softDeleteNetwork' | 'deleteProfile' | 'getProfileByUserId' | 'createNetwork' | 'getNetworkMemberCount' | 'addMemberToNetwork' | 'removeMemberFromIndex' | 'findDuplicateUser' | 'mergeGhostUser' | 'getPremisesForUser' | 'getPremisesForUserInNetworks' | 'createPremise' | 'getPremise' | 'updatePremise' | 'assignPremiseToNetwork' | 'getPremiseNetworks' | 'searchPremisesBySimilarity' | 'searchPremisesBySimilarityBatch' | 'getUserContext' | 'getUserContexts' | 'searchIntentsByContextEmbedding'> & Pick<NegotiationQueries, 'getNegotiationTaskForOpportunity'>;
+export type ChatGraphCompositeDatabase = Pick<Database, 'getProfile' | 'getActiveIntents' | 'getActiveIntentsAcrossIndexes' | 'getIntentsInIndexForMember' | 'getUser' | 'updateUser' | 'getUserSocials' | 'setUserSocials' | 'saveProfile' | 'softDeleteGhost' | 'createIntent' | 'updateIntent' | 'archiveIntent' | 'createOpportunity' | 'createOpportunityIfNetworkEligible' | 'createOpportunityAndExpireIdsIfNetworkEligible' | 'persistIntentScopedOpportunityIfNetworkEligible' | 'updateOpportunityStatusIfNetworkEligible' | 'getOpportunity' | 'getOpportunitiesByIds' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'getOpportunitiesForUser' | 'updateOpportunityStatus' | 'compensateTasklessNegotiatingOpportunity' | 'updateOpportunityActorApproval' | 'stampOpportunityActorAction' | 'getOrCreateDM' | 'getHydeDocument' | 'getHydeDocumentsForSource' | 'saveHydeDocument' | 'getIntent' | 'getPublicIndexesNotJoined' | 'getUserIndexIds' | 'getAssignmentNetworkMembershipsForUser' | 'getAssignmentNetworkIdsForUser' | 'getNetworkMemberships' | 'getNetworkMembership' | 'getActiveNetworkMembershipPairs' | 'getNetwork' | 'getNetworkWithPermissions' | 'getIntentForIndexing' | 'getNetworkMemberContext' | 'getNetworkAssignmentContext' | 'isIntentAssignedToIndex' | 'assignIntentToNetwork' | 'assignIntentToNetworkIfMember' | 'unassignIntentFromIndex' | 'getNetworkIdsForIntent' | 'getIntentIndexScores' | 'getPersonalIndexesForContact' | 'getOwnedIndexes' | 'isIndexOwner' | 'isNetworkMember' | 'getNetworkMembersForOwner' | 'getNetworkMembersForMember' | 'getMembersFromUserIndexes' | 'getNetworkIntentsForOwner' | 'getNetworkIntentsForMember' | 'updateIndexSettings' | 'softDeleteNetwork' | 'deleteProfile' | 'getProfileByUserId' | 'createNetwork' | 'getNetworkMemberCount' | 'addMemberToNetwork' | 'removeMemberFromIndex' | 'findDuplicateUser' | 'mergeGhostUser' | 'getPremisesForUser' | 'getPremisesForUserInNetworks' | 'createPremise' | 'getPremise' | 'updatePremise' | 'assignPremiseToNetwork' | 'getPremiseNetworks' | 'searchPremisesBySimilarity' | 'searchPremisesBySimilarityBatch' | 'getUserContext' | 'getUserContexts' | 'searchIntentsByContextEmbedding' | 'searchUserContextsBySimilarity'> & Pick<NegotiationQueries, 'getNegotiationTaskForOpportunity'>;
 /**
  * Database interface for Opportunity Graph operations.
  * Includes prep/scope (network membership, intents, index details), persist (create, dedupe),
@@ -1919,7 +1938,7 @@ export type ChatGraphCompositeDatabase = Pick<Database, 'getProfile' | 'getActiv
  *
  * Access layer: SystemDatabase (cross-user opportunity operations)
  */
-export type OpportunityGraphDatabase = Pick<Database, 'getProfile' | 'createOpportunity' | 'createOpportunityIfNetworkEligible' | 'createOpportunityAndExpireIdsIfNetworkEligible' | 'persistIntentScopedOpportunityIfNetworkEligible' | 'updateOpportunityStatusIfNetworkEligible' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'getUserIndexIds' | 'getNetworkMemberships' | 'getActiveNetworkMembershipPairs' | 'getActiveIntents' | 'getNetworkIdsForIntent' | 'getNetwork' | 'getNetworkMemberCount' | 'getIntentIndexScores' | 'getNetworkMemberContext' | 'getNetworkAssignmentContext' | 'getOpportunity' | 'getOpportunitiesForUser' | 'updateOpportunityStatus' | 'compensateTasklessNegotiatingOpportunity' | 'stampOpportunityActorAction' | 'updateOpportunityActorApproval' | 'isNetworkMember' | 'isIndexOwner' | 'getUser' | 'getOrCreateDM' | 'getIntent' | 'getPremise' | 'getPremisesForUser' | 'getPremisesForUserInNetworks' | 'searchPremisesBySimilarity' | 'searchPremisesBySimilarityBatch' | 'getUserContext' | 'getUserContexts' | 'searchIntentsByContextEmbedding' | 'getHydeDocumentsForSource' | 'getRecentlyRejectedOpportunityCounterparties'> & Pick<NegotiationQueries, 'getNegotiationTaskForOpportunity'>;
+export type OpportunityGraphDatabase = Pick<Database, 'getProfile' | 'createOpportunity' | 'createOpportunityIfNetworkEligible' | 'createOpportunityAndExpireIdsIfNetworkEligible' | 'persistIntentScopedOpportunityIfNetworkEligible' | 'updateOpportunityStatusIfNetworkEligible' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'getUserIndexIds' | 'getNetworkMemberships' | 'getActiveNetworkMembershipPairs' | 'getActiveIntents' | 'getNetworkIdsForIntent' | 'getNetwork' | 'getNetworkMemberCount' | 'getIntentIndexScores' | 'getNetworkMemberContext' | 'getNetworkAssignmentContext' | 'getOpportunity' | 'getOpportunitiesForUser' | 'updateOpportunityStatus' | 'compensateTasklessNegotiatingOpportunity' | 'stampOpportunityActorAction' | 'updateOpportunityActorApproval' | 'isNetworkMember' | 'isIndexOwner' | 'getUser' | 'getOrCreateDM' | 'getIntent' | 'getPremise' | 'getPremisesForUser' | 'getPremisesForUserInNetworks' | 'searchPremisesBySimilarity' | 'searchPremisesBySimilarityBatch' | 'getUserContext' | 'getUserContexts' | 'searchIntentsByContextEmbedding' | 'searchUserContextsBySimilarity' | 'getHydeDocumentsForSource' | 'getRecentlyRejectedOpportunityCounterparties'> & Pick<NegotiationQueries, 'getNegotiationTaskForOpportunity'>;
 /**
  * Negotiation-specific query operations not covered by generic
  * conversation/task primitives.

package/dist/shared/interfaces/embedder.interface.d.ts

@@ -20,16 +20,30 @@ export interface HydeSearchOptions {
     limit?: number;
     /** Minimum cosine similarity for intent searches (default 0.40). */
     minScore?: number;
+    /**
+     * Discovery corpus gating, composed by the caller (defaults preserve legacy behavior).
+     * Omitted fields default to: intents true, profile true, profileCorpus 'premise'.
+     */
+    corpusGating?: {
+        /** Search the intents corpus. */
+        intents?: boolean;
+        /** Search the active profile corpus. */
+        profile?: boolean;
+        /** Which corpus backs 'profiles' lens hints and profile searches. */
+        profileCorpus?: 'premise' | 'user_context';
+    };
 }
-/** A single candidate from HyDE search (intent or premise), with score and which lens matched. */
+/** A single candidate from HyDE search (intent, premise, or user_context), with score and which lens matched. */
 export interface HydeCandidate {
-    type: 'intent' | 'premise';
+    type: 'intent' | 'premise' | 'user_context';
     id: string;
     userId: string;
     score: number;
     /** Free-text lens label that produced this match. */
     matchedVia: string;
     networkId: string;
+    /** Candidate document text (populated for user_context matches; used as candidatePayload). */
+    text?: string;
     /** Set after merge when user matched via multiple lenses. */
     matchedLenses?: string[];
 }

package/dist/shared/schemas/network-assignment.schema.d.ts

@@ -86,47 +86,50 @@ export declare const NetworkAssignmentMetadataSchema: z.ZodObject<{
     createdAt?: string | undefined;
 }>;
 export type NetworkAssignmentMetadata = z.infer<typeof NetworkAssignmentMetadataSchema>;
-export declare const OpportunityEvidenceKindSchema: z.ZodEnum<["query_intent", "query_premise", "premise_similarity", "context_to_intent", "profile"]>;
+export declare const OpportunityEvidenceKindSchema: z.ZodEnum<["query_intent", "query_premise", "query_context", "premise_similarity", "context_similarity", "context_to_intent", "profile"]>;
 export type OpportunityEvidenceKind = z.infer<typeof OpportunityEvidenceKindSchema>;
 export declare const OpportunityEvidenceSchema: z.ZodObject<{
-    kind: z.ZodEnum<["query_intent", "query_premise", "premise_similarity", "context_to_intent", "profile"]>;
+    kind: z.ZodEnum<["query_intent", "query_premise", "query_context", "premise_similarity", "context_similarity", "context_to_intent", "profile"]>;
     networkId: z.ZodString;
     score: z.ZodOptional<z.ZodNumber>;
     lens: z.ZodOptional<z.ZodString>;
-    discoverySource: z.ZodOptional<z.ZodEnum<["query", "premise-similarity", "context-to-intent"]>>;
+    discoverySource: z.ZodOptional<z.ZodEnum<["query", "premise-similarity", "context-to-intent", "context-similarity"]>>;
     matchedStrategies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     sourcePremiseId: z.ZodOptional<z.ZodString>;
     candidatePremiseId: z.ZodOptional<z.ZodString>;
     candidateIntentId: z.ZodOptional<z.ZodString>;
     sourceContextId: z.ZodOptional<z.ZodString>;
+    candidateContextId: z.ZodOptional<z.ZodString>;
     payload: z.ZodOptional<z.ZodString>;
     summary: z.ZodOptional<z.ZodString>;
     assertionText: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    kind: "query_intent" | "query_premise" | "premise_similarity" | "context_to_intent" | "profile";
+    kind: "query_intent" | "query_premise" | "query_context" | "premise_similarity" | "context_similarity" | "context_to_intent" | "profile";
     networkId: string;
     score?: number | undefined;
     lens?: string | undefined;
-    discoverySource?: "query" | "premise-similarity" | "context-to-intent" | undefined;
+    discoverySource?: "query" | "premise-similarity" | "context-to-intent" | "context-similarity" | undefined;
     matchedStrategies?: string[] | undefined;
     sourcePremiseId?: string | undefined;
     candidatePremiseId?: string | undefined;
     candidateIntentId?: string | undefined;
     sourceContextId?: string | undefined;
+    candidateContextId?: string | undefined;
     payload?: string | undefined;
     summary?: string | undefined;
     assertionText?: string | undefined;
 }, {
-    kind: "query_intent" | "query_premise" | "premise_similarity" | "context_to_intent" | "profile";
+    kind: "query_intent" | "query_premise" | "query_context" | "premise_similarity" | "context_similarity" | "context_to_intent" | "profile";
     networkId: string;
     score?: number | undefined;
     lens?: string | undefined;
-    discoverySource?: "query" | "premise-similarity" | "context-to-intent" | undefined;
+    discoverySource?: "query" | "premise-similarity" | "context-to-intent" | "context-similarity" | undefined;
     matchedStrategies?: string[] | undefined;
     sourcePremiseId?: string | undefined;
     candidatePremiseId?: string | undefined;
     candidateIntentId?: string | undefined;
     sourceContextId?: string | undefined;
+    candidateContextId?: string | undefined;
     payload?: string | undefined;
     summary?: string | undefined;
     assertionText?: string | undefined;

package/dist/shared/schemas/network-assignment.schema.js

@@ -33,7 +33,9 @@ export const NetworkAssignmentMetadataSchema = z.object({
 export const OpportunityEvidenceKindSchema = z.enum([
     "query_intent",
     "query_premise",
+    "query_context",
     "premise_similarity",
+    "context_similarity",
     "context_to_intent",
     "profile",
 ]);
@@ -42,12 +44,13 @@ export const OpportunityEvidenceSchema = z.object({
     networkId: z.string(),
     score: z.number().min(0).max(1).optional(),
     lens: z.string().optional(),
-    discoverySource: z.enum(["query", "premise-similarity", "context-to-intent"]).optional(),
+    discoverySource: z.enum(["query", "premise-similarity", "context-to-intent", "context-similarity"]).optional(),
     matchedStrategies: z.array(z.string()).optional(),
     sourcePremiseId: z.string().optional(),
     candidatePremiseId: z.string().optional(),
     candidateIntentId: z.string().optional(),
     sourceContextId: z.string().optional(),
+    candidateContextId: z.string().optional(),
     payload: z.string().optional(),
     summary: z.string().optional(),
     assertionText: z.string().optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "8.1.1-rc.422.1",
+  "version": "8.3.0-rc.424.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -39,9 +39,11 @@
     "eval:profile": "bun --env-file=../../.env.test ./eval/profile/profile.eval.ts",
     "eval:opportunity": "bun --env-file=../../.env.test ./eval/opportunity/opportunity.eval.ts",
     "eval:clarification": "bun --env-file=../../.env.test ./eval/clarification/clarification.eval.ts",
+    "eval:discovery-retrieval": "bun --env-file=../../.env.test ./eval/discovery-retrieval/discovery-retrieval.eval.ts",
     "eval:canary": "bun --env-file=../../.env.test ./eval/canary/canary.eval.ts",
     "eval:stance": "bun --env-file=../../.env.test ./eval/stance/stance.eval.ts",
     "eval:view": "bun ./eval/viewer/viewer.eval.ts",
+    "eval:web": "bun --env-file=../../.env.test ./eval/ops/ops.serve.ts",
     "eval:verify": "bun ./eval/verify.ts"
   },
   "dependencies": {