@indexnetwork/protocol 8.1.0-rc.421.1 → 8.2.0-rc.423.1

package/dist/opportunity/application/opportunity.graph.js

@@ -29,7 +29,9 @@ import { protocolLogger, withCallLogging } from '../../shared/observability/prot
 import { timed } from '../../shared/observability/performance.js';
 import { renderNetworkContext } from '../../shared/network/metadata.renderer.js';
 import { requestContext } from "../../shared/observability/request-context.js";
+import { getAbortSignalConfig } from "../../shared/agent/model-signal.js";
 import { mergeOpportunityEvidence, withCandidateEvidence, withMatchedStrategies } from '../domain/opportunity.evidence.js';
+import { discoveryIntentMatchingEnabled, discoveryProfileMatchingEnabled, discoveryProfileSource } from '../discovery.env.js';
 import { normalizeOpportunityActorIntent, resolveOpportunityActorIntent } from '../domain/opportunity.actor.js';
 import { approveOpportunityIntroduction, deleteOpportunityLifecycle, sendOpportunityLifecycle, updateOpportunityLifecycle } from './opportunity.lifecycle.js';
 import { stampEligibleNewbornOpportunities } from './opportunity.newborn-stamping.js';
@@ -55,6 +57,14 @@ const deleteLog = protocolLogger('OpportunityGraph:Delete');
 const sendLog = protocolLogger('OpportunityGraph:Send');
 const negotiateExistingLog = protocolLogger('OpportunityGraph:NegotiateExisting');
 const routingLog = protocolLogger('OpportunityGraph:Routing');
+/**
+ * Error text can include provider response bodies, URLs, and credentials. Keep
+ * observability useful by retaining only a conservative error class at this
+ * boundary; detailed errors are intentionally not emitted from graph traces.
+ */
+export function safeOpportunityGraphError(_error) {
+    return 'OpportunityEvaluationError: [redacted]';
+}
 /** Time window for persist-node dedup. Suppresses a second opportunity with the same person while a recent one (within 30 days) is still in flight, so a person is not re-surfaced multiple times within a month (EDG-23). */
 const DEDUP_WINDOW_MS = 30 * 24 * 60 * 60 * 1000;
 const ACTIVE_NEGOTIATION_TASK_STATES = new Set([
@@ -120,7 +130,7 @@ function buildEvaluatorEvidenceKey(candidate) {
     return [
         candidate.candidateUserId,
         candidate.networkId,
-        candidate.candidateIntentId ?? candidate.candidatePremiseId ?? candidate.sourceContextId ?? 'profile',
+        candidate.candidateIntentId ?? candidate.candidatePremiseId ?? candidate.candidateContextId ?? candidate.sourceContextId ?? 'profile',
     ].join(':');
 }
 /**
@@ -237,7 +247,7 @@ export class OpportunityGraphFactory {
                 }
                 catch (err) {
                     const durationMs = Date.now() - nodeStart;
-                    const errMsg = err instanceof Error ? err.message : String(err);
+                    const errMsg = safeOpportunityGraphError(err);
                     traceEmitter?.({ type: "agent_end", name: traceName, durationMs, summary: `error: ${errMsg}` });
                     throw err;
                 }
@@ -287,8 +297,14 @@ export class OpportunityGraphFactory {
             // DISCOVERY_SOURCE_PREMISE_LIMIT. Loading all premises here caused
             // BACKEND-5: thousands of parallel vector searches for premise-rich users.
             const sourcePremises = [];
-            const contextToIntentEnabled = process.env.DISCOVERY_CONTEXT_TO_INTENT !== '0';
-            const rawContexts = contextToIntentEnabled && typeof this.database.getUserContexts === 'function'
+            const profileEnabled = discoveryProfileMatchingEnabled();
+            // Context-backed discovery is exclusively the user_context profile-source
+            // strategy. Premise mode must not load contexts or emit context-to-intent
+            // evidence merely because intent matching is also enabled.
+            const userContextProfileEnabled = profileEnabled && discoveryProfileSource() === 'user_context';
+            const contextToIntentEnabled = userContextProfileEnabled && process.env.DISCOVERY_CONTEXT_TO_INTENT !== '0';
+            const contextToContextEnabled = userContextProfileEnabled;
+            const rawContexts = (contextToIntentEnabled || contextToContextEnabled) && typeof this.database.getUserContexts === 'function'
                 ? await this.database.getUserContexts(discoveryUserId)
                 : [];
             const sourceContexts = rawContexts
@@ -731,6 +747,17 @@ export class OpportunityGraphFactory {
                     const perIndexLimit = 80;
                     // Similarity threshold for recall (0.30 = 30% similarity)
                     const minScore = 0.3;
+                    // Discovery match-type gating (DISCOVERY_ALLOWED_TYPES / DISCOVERY_PROFILE_SOURCE).
+                    // Result filtering below is defense-in-depth: corpusGating already scopes the
+                    // embedder's corpus searches, but adapters may still return other types.
+                    const intentResultsEnabled = discoveryIntentMatchingEnabled();
+                    const premiseResultsEnabled = discoveryProfileMatchingEnabled() && discoveryProfileSource() === 'premise';
+                    const contextResultsEnabled = discoveryProfileMatchingEnabled() && discoveryProfileSource() === 'user_context';
+                    const corpusGating = {
+                        intents: discoveryIntentMatchingEnabled(),
+                        profile: discoveryProfileMatchingEnabled(),
+                        profileCorpus: discoveryProfileSource(),
+                    };
                     if (state.discoverySource === 'context') {
                         // Context discovery: HyDE (when search query exists) + premise-to-premise.
                         if (state.searchQuery?.trim()) {
@@ -791,26 +818,31 @@ export class OpportunityGraphFactory {
                                     model: getModelName("hydeGenerator"),
                                 },
                             });
-                            const [premiseCands, contextCands] = await Promise.all([
+                            const [premiseCands, contextCands, contextSimCands] = await Promise.all([
                                 runPremiseDiscovery(),
                                 runContextToIntentDiscovery(),
+                                runContextToContextDiscovery(),
                             ]);
-                            const withPremisesAndContext = mergeStrategyCandidates(queryCandidates, premiseCands, contextCands);
+                            const withPremisesAndContext = mergeStrategyCandidates(queryCandidates, premiseCands, contextCands, contextSimCands);
                             if (premiseCands.length > 0) {
                                 traceEntries.push({ node: "strategy", detail: `premise-to-premise → ${premiseCands.length} candidate(s)` });
                             }
                             if (contextCands.length > 0) {
                                 traceEntries.push({ node: "strategy", detail: `context-to-intent → ${contextCands.length} candidate(s)` });
                             }
+                            if (contextSimCands.length > 0) {
+                                traceEntries.push({ node: "strategy", detail: `context-to-context → ${contextSimCands.length} candidate(s)` });
+                            }
                             return { candidates: filterByTarget(withPremisesAndContext), trace: traceEntries };
                         }
                         // No search query — premise-to-premise + context-to-intent discovery
-                        const [premiseCands, contextCands] = await Promise.all([
+                        const [premiseCands, contextCands, contextSimCands] = await Promise.all([
                             runPremiseDiscovery(),
                             runContextToIntentDiscovery(),
+                            runContextToContextDiscovery(),
                         ]);
-                        if (premiseCands.length > 0 || contextCands.length > 0) {
-                            const merged = mergeStrategyCandidates(premiseCands, contextCands);
+                        if (premiseCands.length > 0 || contextCands.length > 0 || contextSimCands.length > 0) {
+                            const merged = mergeStrategyCandidates(premiseCands, contextCands, contextSimCands);
                             const traceEntries = [];
                             if (premiseCands.length > 0) {
                                 traceEntries.push({ node: "strategy", detail: `premise-to-premise → ${premiseCands.length} candidate(s)` });
@@ -818,9 +850,12 @@ export class OpportunityGraphFactory {
                             if (contextCands.length > 0) {
                                 traceEntries.push({ node: "strategy", detail: `context-to-intent → ${contextCands.length} candidate(s)` });
                             }
+                            if (contextSimCands.length > 0) {
+                                traceEntries.push({ node: "strategy", detail: `context-to-context → ${contextSimCands.length} candidate(s)` });
+                            }
                             traceEntries.push({
                                 node: "discovery",
-                                detail: `${[premiseCands.length > 0 && 'premise-to-premise', contextCands.length > 0 && 'context-to-intent'].filter(Boolean).length} strategies → ${premiseCands.length + contextCands.length} raw, ${merged.length} after dedup`,
+                                detail: `${[premiseCands.length > 0 && 'premise-to-premise', contextCands.length > 0 && 'context-to-intent', contextSimCands.length > 0 && 'context-to-context'].filter(Boolean).length} strategies → ${premiseCands.length + contextCands.length + contextSimCands.length} raw, ${merged.length} after dedup`,
                             });
                             return { candidates: filterByTarget(merged), trace: traceEntries };
                         }
@@ -871,31 +906,47 @@ export class OpportunityGraphFactory {
                                 limitPerStrategy,
                                 limit: perIndexLimit,
                                 minScore,
+                                corpusGating,
                             });
-                            for (const r of results.filter((x) => x.type === 'intent')) {
-                                all.push(withCandidateEvidence({
-                                    candidateUserId: r.userId,
-                                    candidateIntentId: r.id,
-                                    networkId: targetIndex.networkId,
-                                    similarity: r.score,
-                                    lens: r.matchedVia,
-                                    candidatePayload: '',
-                                    candidateSummary: undefined,
-                                    discoverySource: 'query',
-                                }));
-                            }
-                            for (const r of results.filter((x) => x.type === 'premise')) {
-                                all.push(withCandidateEvidence({
-                                    candidateUserId: r.userId,
-                                    candidatePremiseId: r.id,
-                                    networkId: targetIndex.networkId,
-                                    similarity: r.score,
-                                    lens: r.matchedVia,
-                                    candidatePayload: '',
-                                    candidateSummary: undefined,
-                                    discoverySource: 'query',
-                                }));
-                            }
+                            if (intentResultsEnabled)
+                                for (const r of results.filter((x) => x.type === 'intent')) {
+                                    all.push(withCandidateEvidence({
+                                        candidateUserId: r.userId,
+                                        candidateIntentId: r.id,
+                                        networkId: targetIndex.networkId,
+                                        similarity: r.score,
+                                        lens: r.matchedVia,
+                                        candidatePayload: '',
+                                        candidateSummary: undefined,
+                                        discoverySource: 'query',
+                                    }));
+                                }
+                            if (premiseResultsEnabled)
+                                for (const r of results.filter((x) => x.type === 'premise')) {
+                                    all.push(withCandidateEvidence({
+                                        candidateUserId: r.userId,
+                                        candidatePremiseId: r.id,
+                                        networkId: targetIndex.networkId,
+                                        similarity: r.score,
+                                        lens: r.matchedVia,
+                                        candidatePayload: '',
+                                        candidateSummary: undefined,
+                                        discoverySource: 'query',
+                                    }));
+                                }
+                            if (contextResultsEnabled)
+                                for (const r of results.filter((x) => x.type === 'user_context')) {
+                                    all.push(withCandidateEvidence({
+                                        candidateUserId: r.userId,
+                                        candidateContextId: r.id,
+                                        networkId: targetIndex.networkId,
+                                        similarity: r.score,
+                                        lens: r.matchedVia,
+                                        candidatePayload: r.text ?? '',
+                                        candidateSummary: undefined,
+                                        discoverySource: 'query',
+                                    }));
+                                }
                         }));
                         const intentCount = all.filter((c) => c.candidateIntentId).length;
                         const premiseCount = all.filter((c) => c.candidatePremiseId).length;
@@ -903,12 +954,17 @@ export class OpportunityGraphFactory {
                             total: all.length,
                             fromIntent: intentCount,
                             fromPremise: premiseCount,
+                            fromContext: all.filter((c) => c.candidateContextId).length,
                         });
                         const byKey = new Map();
                         for (const c of all) {
                             // Dedup by candidateUserId + entity (intent or premise), NOT by indexId.
                             // Including indexId caused the same user to appear once per index they belong to.
-                            const entityKey = c.candidateIntentId ? `intent:${c.candidateIntentId}` : `premise:${c.candidatePremiseId}`;
+                            const entityKey = c.candidateIntentId
+                                ? `intent:${c.candidateIntentId}`
+                                : c.candidatePremiseId
+                                    ? `premise:${c.candidatePremiseId}`
+                                    : `context:${c.candidateContextId}`;
                             const key = `${c.candidateUserId}:${entityKey}`;
                             if (!byKey.has(key) || c.similarity > (byKey.get(key)?.similarity ?? 0)) {
                                 byKey.set(key, c);
@@ -925,6 +981,10 @@ export class OpportunityGraphFactory {
                         const targetNetworkIds = state.targetNetworks.map(t => t.networkId);
                         if (targetNetworkIds.length === 0)
                             return [];
+                        if (!discoveryProfileMatchingEnabled() || discoveryProfileSource() === 'user_context') {
+                            discoveryLog.verbose('runPremiseDiscovery disabled by DISCOVERY_ALLOWED_TYPES/DISCOVERY_PROFILE_SOURCE');
+                            return [];
+                        }
                         const sourceLimit = getSourcePremiseDiscoveryLimit();
                         if (sourceLimit === 0) {
                             discoveryLog.verbose('runPremiseDiscovery disabled by DISCOVERY_SOURCE_PREMISE_LIMIT=0');
@@ -1004,6 +1064,8 @@ export class OpportunityGraphFactory {
                         const contextToIntentEnabled = process.env.DISCOVERY_CONTEXT_TO_INTENT !== '0';
                         if (!contextToIntentEnabled)
                             return [];
+                        if (!discoveryProfileMatchingEnabled() || discoveryProfileSource() !== 'user_context' || !discoveryIntentMatchingEnabled())
+                            return [];
                         const targetNetworkIds = state.targetNetworks.map(t => t.networkId);
                         if (targetNetworkIds.length === 0)
                             return [];
@@ -1031,6 +1093,7 @@ export class OpportunityGraphFactory {
                                     limitPerStrategy: limitPerStrategy,
                                     limit: 20,
                                     minScore,
+                                    corpusGating,
                                 });
                                 for (const r of results.filter(r => r.type === 'intent')) {
                                     contextCandidates.push(withCandidateEvidence({
@@ -1084,6 +1147,60 @@ export class OpportunityGraphFactory {
                         });
                         return deduped;
                     }
+                    /**
+                     * Context-to-context discovery (lightweight profile mode only).
+                     * Raw network-scoped context embeddings → candidate user_contexts.
+                     * No HyDE: both sides are the same document type (synthesized
+                     * 3–6 sentence paragraphs), so direct paragraph similarity is correct
+                     * (same rationale as raw premise-to-premise).
+                     */
+                    async function runContextToContextDiscovery() {
+                        if (!contextResultsEnabled)
+                            return [];
+                        if (!state.sourceContexts?.length)
+                            return [];
+                        if (typeof self.database.searchUserContextsBySimilarity !== 'function')
+                            return [];
+                        const targetNetworkIds = state.targetNetworks.map(t => t.networkId);
+                        if (targetNetworkIds.length === 0)
+                            return [];
+                        const contextCandidates = [];
+                        for (const ctx of state.sourceContexts.filter(c => targetNetworkIds.includes(c.networkId))) {
+                            const results = await self.database.searchUserContextsBySimilarity({
+                                embedding: ctx.embedding,
+                                networkIds: [ctx.networkId],
+                                excludeUserId: discoveryUserId,
+                                limit: 20,
+                                minScore,
+                            });
+                            for (const r of results) {
+                                contextCandidates.push(withCandidateEvidence({
+                                    candidateUserId: r.userId,
+                                    candidateContextId: r.contextId,
+                                    sourceContextId: ctx.contextId,
+                                    networkId: r.networkId,
+                                    similarity: typeof r.similarity === 'number' ? r.similarity : parseFloat(String(r.similarity)),
+                                    lens: 'context_match',
+                                    candidatePayload: r.text ?? '',
+                                    discoverySource: 'context-similarity',
+                                }));
+                            }
+                        }
+                        // Dedup by userId + contextId + networkId (mirror premise dedup)
+                        const byKey = new Map();
+                        for (const c of contextCandidates) {
+                            const key = `${c.candidateUserId}:${c.candidateContextId ?? 'none'}:${c.networkId}`;
+                            if (!byKey.has(key) || c.similarity > (byKey.get(key)?.similarity ?? 0)) {
+                                byKey.set(key, c);
+                            }
+                        }
+                        const deduped = Array.from(byKey.values());
+                        discoveryLog.verbose('runContextToContextDiscovery complete', {
+                            rawCount: contextCandidates.length,
+                            dedupedCount: deduped.length,
+                        });
+                        return deduped;
+                    }
                     /**
                      * Merge candidates from multiple strategies. Deduplicates by userId + networkId + entityId,
                      * keeps the highest similarity, tracks which strategies found each candidate,
@@ -1094,7 +1211,7 @@ export class OpportunityGraphFactory {
                         const merged = new Map();
                         for (const group of groups) {
                             for (const c of group) {
-                                const entityId = c.candidateIntentId ?? c.candidatePremiseId ?? 'none';
+                                const entityId = c.candidateIntentId ?? c.candidatePremiseId ?? c.candidateContextId ?? 'none';
                                 const key = `${c.candidateUserId}:${c.networkId}:${entityId}`;
                                 const existing = merged.get(key);
                                 if (!existing) {
@@ -1129,15 +1246,16 @@ export class OpportunityGraphFactory {
                     const searchText = state.searchQuery ?? resolvedIntent?.payload ?? '';
                     if (!searchText) {
                         discoveryLog.warn('No search text available for intent path');
-                        const [premiseCands, contextCands] = await Promise.all([
+                        const [premiseCands, contextCands, contextSimCands] = await Promise.all([
                             runPremiseDiscovery(),
                             runContextToIntentDiscovery(),
+                            runContextToContextDiscovery(),
                         ]);
-                        const merged = mergeStrategyCandidates(premiseCands, contextCands);
+                        const merged = mergeStrategyCandidates(premiseCands, contextCands, contextSimCands);
                         if (merged.length > 0) {
                             return {
                                 candidates: filterByTarget(merged),
-                                trace: [{ node: "discovery", detail: `No search text; premise → ${premiseCands.length}, context → ${contextCands.length}, merged → ${merged.length} candidate(s)` }],
+                                trace: [{ node: "discovery", detail: `No search text; premise → ${premiseCands.length}, context → ${contextCands.length}, context-sim → ${contextSimCands.length}, merged → ${merged.length} candidate(s)` }],
                             };
                         }
                         return { candidates: [] };
@@ -1156,16 +1274,17 @@ export class OpportunityGraphFactory {
                     const hydeEmbeddings = hydeResult.hydeEmbeddings;
                     const lenses = hydeResult.lenses ?? [];
                     if (!hydeEmbeddings || Object.keys(hydeEmbeddings).length === 0) {
-                        const [premiseCands, contextCands] = await Promise.all([
+                        const [premiseCands, contextCands, contextSimCands] = await Promise.all([
                             runPremiseDiscovery(),
                             runContextToIntentDiscovery(),
+                            runContextToContextDiscovery(),
                         ]);
-                        const merged = mergeStrategyCandidates(premiseCands, contextCands);
+                        const merged = mergeStrategyCandidates(premiseCands, contextCands, contextSimCands);
                         if (merged.length > 0) {
                             return {
                                 hydeEmbeddings: {},
                                 candidates: filterByTarget(merged),
-                                trace: [{ node: "discovery", detail: `No HyDE embeddings; premise → ${premiseCands.length}, context → ${contextCands.length}, merged → ${merged.length} candidate(s)` }],
+                                trace: [{ node: "discovery", detail: `No HyDE embeddings; premise → ${premiseCands.length}, context → ${contextCands.length}, context-sim → ${contextSimCands.length}, merged → ${merged.length} candidate(s)` }],
                             };
                         }
                         return { hydeEmbeddings: {}, candidates: [] };
@@ -1186,35 +1305,55 @@ export class OpportunityGraphFactory {
                             limitPerStrategy,
                             limit: perIndexLimit,
                             minScore,
+                            corpusGating,
                         });
-                        for (const result of results.filter((r) => r.type === 'intent')) {
-                            allCandidates.push(withCandidateEvidence({
-                                candidateUserId: result.userId,
-                                candidateIntentId: result.id,
-                                networkId: targetIndex.networkId,
-                                similarity: result.score,
-                                lens: result.matchedVia,
-                                candidatePayload: '',
-                                candidateSummary: undefined,
-                                discoverySource: 'query',
-                            }));
-                        }
-                        for (const result of results.filter((r) => r.type === 'premise')) {
-                            allCandidates.push(withCandidateEvidence({
-                                candidateUserId: result.userId,
-                                candidatePremiseId: result.id,
-                                networkId: targetIndex.networkId,
-                                similarity: result.score,
-                                lens: result.matchedVia,
-                                candidatePayload: '',
-                                candidateSummary: undefined,
-                                discoverySource: 'query',
-                            }));
-                        }
+                        if (intentResultsEnabled)
+                            for (const result of results.filter((r) => r.type === 'intent')) {
+                                allCandidates.push(withCandidateEvidence({
+                                    candidateUserId: result.userId,
+                                    candidateIntentId: result.id,
+                                    networkId: targetIndex.networkId,
+                                    similarity: result.score,
+                                    lens: result.matchedVia,
+                                    candidatePayload: '',
+                                    candidateSummary: undefined,
+                                    discoverySource: 'query',
+                                }));
+                            }
+                        if (premiseResultsEnabled)
+                            for (const result of results.filter((r) => r.type === 'premise')) {
+                                allCandidates.push(withCandidateEvidence({
+                                    candidateUserId: result.userId,
+                                    candidatePremiseId: result.id,
+                                    networkId: targetIndex.networkId,
+                                    similarity: result.score,
+                                    lens: result.matchedVia,
+                                    candidatePayload: '',
+                                    candidateSummary: undefined,
+                                    discoverySource: 'query',
+                                }));
+                            }
+                        if (contextResultsEnabled)
+                            for (const result of results.filter((r) => r.type === 'user_context')) {
+                                allCandidates.push(withCandidateEvidence({
+                                    candidateUserId: result.userId,
+                                    candidateContextId: result.id,
+                                    networkId: targetIndex.networkId,
+                                    similarity: result.score,
+                                    lens: result.matchedVia,
+                                    candidatePayload: result.text ?? '',
+                                    candidateSummary: undefined,
+                                    discoverySource: 'query',
+                                }));
+                            }
                     }));
                     const byUserAndIndex = new Map();
                     for (const c of allCandidates) {
-                        const entityKey = c.candidateIntentId ? `intent:${c.candidateIntentId}` : `premise:${c.candidatePremiseId}`;
+                        const entityKey = c.candidateIntentId
+                            ? `intent:${c.candidateIntentId}`
+                            : c.candidatePremiseId
+                                ? `premise:${c.candidatePremiseId}`
+                                : `context:${c.candidateContextId}`;
                         const key = `${c.candidateUserId}:${c.networkId}:${entityKey}`;
                         if (!byUserAndIndex.has(key) || c.similarity > (byUserAndIndex.get(key)?.similarity ?? 0)) {
                             byUserAndIndex.set(key, c);
@@ -1295,15 +1434,16 @@ export class OpportunityGraphFactory {
                             },
                         });
                     }
-                    const [premiseCands, contextCands] = await Promise.all([
+                    const [premiseCands, contextCands, contextSimCands] = await Promise.all([
                         runPremiseDiscovery(),
                         runContextToIntentDiscovery(),
+                        runContextToContextDiscovery(),
                     ]);
-                    const allStrategies = mergeStrategyCandidates(candidates, premiseCands, contextCands);
-                    if (premiseCands.length > 0 || contextCands.length > 0) {
+                    const allStrategies = mergeStrategyCandidates(candidates, premiseCands, contextCands, contextSimCands);
+                    if (premiseCands.length > 0 || contextCands.length > 0 || contextSimCands.length > 0) {
                         traceEntries.push({
                             node: "discovery",
-                            detail: `+ Premise → ${premiseCands.length}, Context → ${contextCands.length}, merged to ${allStrategies.length} candidate(s)`,
+                            detail: `+ Premise → ${premiseCands.length}, Context → ${contextCands.length}, Context-sim → ${contextSimCands.length}, merged to ${allStrategies.length} candidate(s)`,
                         });
                     }
                     return {
@@ -1437,7 +1577,7 @@ export class OpportunityGraphFactory {
                     }
                     catch (err) {
                         evaluationLog.warn('IND-567 rejection cool-down: lookup failed, skipping penalty', {
-                            error: err instanceof Error ? err.message : String(err),
+                            error: safeOpportunityGraphError(err),
                         });
                     }
                 }
@@ -1493,6 +1633,7 @@ export class OpportunityGraphFactory {
                         const profile = await this.database.getProfile(c.candidateUserId);
                         let intentPayload = c.candidatePayload;
                         let intentSummary = c.candidateSummary;
+                        let evidence = c.evidence;
                         if (c.candidateIntentId != null && (!intentPayload || intentPayload === '')) {
                             const intent = await this.database.getIntent(c.candidateIntentId);
                             if (intent) {
@@ -1500,6 +1641,16 @@ export class OpportunityGraphFactory {
                                 intentSummary = intent.summary ?? undefined;
                             }
                         }
+                        if (c.candidatePremiseId != null && (!intentPayload || intentPayload === '')) {
+                            const premise = await this.database.getPremise(c.candidatePremiseId);
+                            if (premise) {
+                                intentPayload = premise.assertion.text;
+                                intentSummary = premise.assertion.summary;
+                                evidence = (c.evidence ?? []).map((item) => item.candidatePremiseId === c.candidatePremiseId
+                                    ? { ...item, payload: premise.assertion.text, summary: premise.assertion.summary, assertionText: premise.assertion.text }
+                                    : item);
+                            }
+                        }
                         const evidenceKey = buildEvaluatorEvidenceKey(c);
                         return {
                             userId: c.candidateUserId,
@@ -1516,7 +1667,7 @@ export class OpportunityGraphFactory {
                             evidenceKey,
                             ragScore: c.similarity * 100,
                             matchedVia: c.lens,
-                            evidence: c.evidence,
+                            evidence,
                         };
                     }));
                     const userIdToIndexId = new Map();
@@ -1545,6 +1696,7 @@ export class OpportunityGraphFactory {
                     }
                     // Lower default threshold to 50 for better recall
                     const minScore = state.options.minScore ?? 50;
+                    const evaluatorSignalConfig = getAbortSignalConfig();
                     const evaluator = typeof evaluatorAgent.invokeEntityBundle === 'function'
                         ? evaluatorAgent
                         : new OpportunityEvaluator();
@@ -1569,7 +1721,7 @@ export class OpportunityGraphFactory {
                             const _traceEmitter = requestContext.getStore()?.traceEmitter;
                             _traceEmitter?.({ type: "agent_start", name: "opportunity-evaluator" });
                             const _candidateName = candidateEntity.profile?.name ?? "Unknown";
-                            return evaluator.invokeEntityBundle(input, { minScore, returnAll: true })
+                            return evaluator.invokeEntityBundle(input, { minScore, returnAll: true, ...evaluatorSignalConfig })
                                 .then((res) => {
                                 const _evalDuration = Date.now() - _evalStart;
                                 agentTimingsAccum.push({ name: 'opportunity.evaluator', durationMs: _evalDuration });
@@ -1580,12 +1732,12 @@ export class OpportunityGraphFactory {
                             })
                                 .catch((err) => {
                                 const _evalDuration = Date.now() - _evalStart;
-                                const _errMsg = err instanceof Error ? err.message : String(err);
+                                const _errMsg = safeOpportunityGraphError(err);
                                 agentTimingsAccum.push({ name: 'opportunity.evaluator', durationMs: _evalDuration });
                                 _traceEmitter?.({ type: "agent_end", name: "opportunity-evaluator", durationMs: _evalDuration, summary: `${_candidateName}: error — ${_errMsg}` });
                                 evaluationLog.warn('Parallel eval failed for candidate', {
                                     candidateUserId: candidateEntity.userId,
-                                    error: err,
+                                    error: _errMsg,
                                 });
                                 parallelErrors.push({
                                     candidateUserId: candidateEntity.userId,
@@ -1632,14 +1784,14 @@ export class OpportunityGraphFactory {
                         _traceEmitterSerial?.({ type: "agent_start", name: "opportunity-evaluator" });
                         let opportunitiesWithActors;
                         try {
-                            opportunitiesWithActors = await evaluator.invokeEntityBundle(input, { minScore, returnAll: true });
+                            opportunitiesWithActors = await evaluator.invokeEntityBundle(input, { minScore, returnAll: true, ...evaluatorSignalConfig });
                             const _evalDuration = Date.now() - _evalStart;
                             agentTimingsAccum.push({ name: 'opportunity.evaluator', durationMs: _evalDuration });
                             _traceEmitterSerial?.({ type: "agent_end", name: "opportunity-evaluator", durationMs: _evalDuration, summary: `Evaluated ${candidateEntities.length} candidate(s)` });
                         }
                         catch (serialErr) {
                             const _evalDuration = Date.now() - _evalStart;
-                            const _errMsg = serialErr instanceof Error ? serialErr.message : String(serialErr);
+                            const _errMsg = safeOpportunityGraphError(serialErr);
                             agentTimingsAccum.push({ name: 'opportunity.evaluator', durationMs: _evalDuration });
                             _traceEmitterSerial?.({ type: "agent_end", name: "opportunity-evaluator", durationMs: _evalDuration, summary: `error — ${_errMsg}` });
                             throw serialErr; // Re-throw for the outer catch to handle
@@ -1816,8 +1968,8 @@ export class OpportunityGraphFactory {
                     };
                 }
                 catch (error) {
-                    const errMsg = error instanceof Error ? error.message : String(error);
-                    evaluationLog.error('Failed', { error });
+                    const errMsg = safeOpportunityGraphError(error);
+                    evaluationLog.error('Failed', { error: errMsg });
                     return {
                         evaluatedOpportunities: [],
                         error: 'Failed to evaluate candidates.',
@@ -2391,7 +2543,7 @@ export class OpportunityGraphFactory {
                     _evalStart = Date.now();
                     _traceEmitterIntro?.({ type: "agent_start", name: "intro-evaluator" });
                     _introEvalStarted = true;
-                    const evaluated = await evaluatorAgent.invokeEntityBundle(input, { minScore: 0 });
+                    const evaluated = await evaluatorAgent.invokeEntityBundle(input, { minScore: 0, ...getAbortSignalConfig() });
                     const _introDuration = Date.now() - _evalStart;
                     agentTimingsAccum.push({ name: 'opportunity.evaluator', durationMs: _introDuration });
                     _traceEmitterIntro?.({ type: "agent_end", name: "intro-evaluator", durationMs: _introDuration, summary: "Evaluated introduction" });

package/dist/opportunity/discovery.env.d.ts

@@ -0,0 +1,14 @@
+/** Data types allowed to participate in opportunity matching. */
+export type DiscoveryMatchType = 'intent' | 'profile';
+/** Test hook: clear warn-once state so each test observes warnings. */
+export declare function resetDiscoveryEnvWarningsForTests(): void;
+/** Current DISCOVERY_ALLOWED_TYPES set (default: intent + profile). */
+export declare function discoveryAllowedTypes(): ReadonlySet<DiscoveryMatchType>;
+/** True when intents may participate in matching (source or candidate). */
+export declare function discoveryIntentMatchingEnabled(): boolean;
+/** True when profile data (premises or user_contexts) may participate. */
+export declare function discoveryProfileMatchingEnabled(): boolean;
+/** What "profile" means in matching: heavyweight premises or lightweight user_contexts. */
+export type DiscoveryProfileSource = 'premise' | 'user_context';
+/** Current DISCOVERY_PROFILE_SOURCE (default: premise). */
+export declare function discoveryProfileSource(): DiscoveryProfileSource;