@indexnetwork/protocol 4.15.0-rc.357.1 → 4.16.1-rc.359.1

package/dist/shared/hyde/lens.inferrer.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Lens Inferrer Agent: analyzes source text (intent or query) with optional
+ * profile context and infers 1-N search lenses, each tagged with a target corpus.
+ * Replaces the hardcoded HydeStrategy enum and regex-based selectStrategiesFromQuery.
+ */
+import type { BaseLanguageModelInput } from '@langchain/core/language_models/base';
+import { z } from 'zod';
+import { type HydeSourceFrame } from './hyde.frame.js';
 export type HydeTargetCorpus = 'profiles' | 'intents' | 'premises';
 /** A single inferred lens — a search perspective the LLM decided is relevant. */
 export interface Lens {
@@ -15,23 +23,193 @@ export interface LensInferenceInput {
     profileContext?: string;
     /** Maximum number of lenses to infer (default 3). */
     maxLenses?: number;
+    /** Use the source-grounded frame-v1 inference path. */
+    frameConstrained?: boolean;
 }
 export interface LensInferenceOutput {
     lenses: Lens[];
+    /** Sanitized source frame, present only for frame-constrained inference. */
+    sourceFrame?: HydeSourceFrame;
 }
-/**
- * Infers search lenses from source text and optional profile context.
- * Each lens represents a search perspective tagged with a target corpus
- * (profiles or intents) for downstream HyDE document generation.
- */
+/** Source-grounded system prompt used only by frame extraction. */
+export declare const FRAME_SYSTEM_PROMPT = "You extract a source-grounded frame for semantic retrieval from sourceText alone.\n\nSource-frame rules:\n- Extract evidence ONLY from sourceText.\n- Every frame element must include an evidence field copied as an exact substring of sourceText.\n- sourceRoles describe roles held or offered by the source side.\n- sourceRoles and counterpartRoles MUST use generic lower-case role labels only (for example, \"founder\", \"investor\", or \"technical advisor\"). Never put a person, organization, product, location, time, number, credential, or exclusivity detail in a role label.\n- counterpartRoles describe reciprocal or complementary target roles. A generic role may be inferred, but its evidence must be an exact sourceText span that supports the inference.\n- hardConstraints contain only explicit constraints and classify each as location, time, numeric, credential, organization, exclusivity, or other.\n- namedEntities contain only proper names explicitly present in sourceText and classify each as person, organization, product, location, event, or other.\n- domainVocabulary contains source domain terms worth preserving.";
+/** Structured-output schema used only by source-frame extraction. */
+export declare const FrameResponseSchema: z.ZodObject<{
+    sourceFrame: z.ZodObject<{
+        sourceRoles: z.ZodArray<z.ZodObject<{
+            role: z.ZodString;
+            evidence: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            role: string;
+            evidence: string;
+        }, {
+            role: string;
+            evidence: string;
+        }>, "many">;
+        counterpartRoles: z.ZodArray<z.ZodObject<{
+            role: z.ZodString;
+            evidence: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            role: string;
+            evidence: string;
+        }, {
+            role: string;
+            evidence: string;
+        }>, "many">;
+        hardConstraints: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<["location", "time", "numeric", "credential", "organization", "exclusivity", "other"]>;
+            value: z.ZodString;
+            evidence: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            type: "location" | "time" | "numeric" | "credential" | "organization" | "exclusivity" | "other";
+            evidence: string;
+        }, {
+            value: string;
+            type: "location" | "time" | "numeric" | "credential" | "organization" | "exclusivity" | "other";
+            evidence: string;
+        }>, "many">;
+        namedEntities: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<["person", "organization", "product", "location", "event", "other"]>;
+            name: z.ZodString;
+            evidence: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "location" | "event" | "organization" | "other" | "person" | "product";
+            name: string;
+            evidence: string;
+        }, {
+            type: "location" | "event" | "organization" | "other" | "person" | "product";
+            name: string;
+            evidence: string;
+        }>, "many">;
+        domainVocabulary: z.ZodArray<z.ZodObject<{
+            term: z.ZodString;
+            evidence: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            evidence: string;
+            term: string;
+        }, {
+            evidence: string;
+            term: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        sourceRoles: {
+            role: string;
+            evidence: string;
+        }[];
+        counterpartRoles: {
+            role: string;
+            evidence: string;
+        }[];
+        hardConstraints: {
+            value: string;
+            type: "location" | "time" | "numeric" | "credential" | "organization" | "exclusivity" | "other";
+            evidence: string;
+        }[];
+        namedEntities: {
+            type: "location" | "event" | "organization" | "other" | "person" | "product";
+            name: string;
+            evidence: string;
+        }[];
+        domainVocabulary: {
+            evidence: string;
+            term: string;
+        }[];
+    }, {
+        sourceRoles: {
+            role: string;
+            evidence: string;
+        }[];
+        counterpartRoles: {
+            role: string;
+            evidence: string;
+        }[];
+        hardConstraints: {
+            value: string;
+            type: "location" | "time" | "numeric" | "credential" | "organization" | "exclusivity" | "other";
+            evidence: string;
+        }[];
+        namedEntities: {
+            type: "location" | "event" | "organization" | "other" | "person" | "product";
+            name: string;
+            evidence: string;
+        }[];
+        domainVocabulary: {
+            evidence: string;
+            term: string;
+        }[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    sourceFrame: {
+        sourceRoles: {
+            role: string;
+            evidence: string;
+        }[];
+        counterpartRoles: {
+            role: string;
+            evidence: string;
+        }[];
+        hardConstraints: {
+            value: string;
+            type: "location" | "time" | "numeric" | "credential" | "organization" | "exclusivity" | "other";
+            evidence: string;
+        }[];
+        namedEntities: {
+            type: "location" | "event" | "organization" | "other" | "person" | "product";
+            name: string;
+            evidence: string;
+        }[];
+        domainVocabulary: {
+            evidence: string;
+            term: string;
+        }[];
+    };
+}, {
+    sourceFrame: {
+        sourceRoles: {
+            role: string;
+            evidence: string;
+        }[];
+        counterpartRoles: {
+            role: string;
+            evidence: string;
+        }[];
+        hardConstraints: {
+            value: string;
+            type: "location" | "time" | "numeric" | "credential" | "organization" | "exclusivity" | "other";
+            evidence: string;
+        }[];
+        namedEntities: {
+            type: "location" | "event" | "organization" | "other" | "person" | "product";
+            name: string;
+            evidence: string;
+        }[];
+        domainVocabulary: {
+            evidence: string;
+            term: string;
+        }[];
+    };
+}>;
+type ModelInput = BaseLanguageModelInput;
+/** Minimal structured model contract used for deterministic injection in tests. */
+export interface LensStructuredModel {
+    invoke(input: ModelInput, config?: {
+        signal?: AbortSignal;
+    }): Promise<unknown>;
+}
+export interface LensInferrerOptions {
+    legacyModel?: LensStructuredModel;
+    frameModel?: LensStructuredModel;
+}
+/** Infers search lenses from source text and optional profile context. */
 export declare class LensInferrer {
-    private model;
-    /**
-     * Infer search lenses from source text and optional profile context.
-     *
-     * @param input - Source text, optional profile context, optional max lenses
-     * @returns Array of inferred lenses with corpus tags; empty array on failure
-     */
+    private legacyModel?;
+    private frameModel?;
+    constructor(options?: LensInferrerOptions);
+    private getLegacyModel;
+    private getFrameModel;
+    /** Infer search lenses while preserving the legacy path unless explicitly enabled. */
     infer(input: LensInferenceInput): Promise<LensInferenceOutput>;
 }
+export {};
 //# sourceMappingURL=lens.inferrer.d.ts.map

package/dist/shared/hyde/lens.inferrer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lens.inferrer.d.ts","sourceRoot":"/","sources":["shared/hyde/lens.inferrer.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAEnE,iFAAiF;AACjF,MAAM,WAAW,IAAI;IACnB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,MAAM,EAAE,gBAAgB,CAAC;IACzB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,IAAI,EAAE,CAAC;CAChB;AA4BD;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAEV;IAEH;;;;;OAKG;IAEG,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAoCrE"}
+{"version":3,"file":"lens.inferrer.d.ts","sourceRoot":"/","sources":["shared/hyde/lens.inferrer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAEnF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,EAAkD,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvG,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAEnE,iFAAiF;AACjF,MAAM,WAAW,IAAI;IACnB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,MAAM,EAAE,gBAAgB,CAAC;IACzB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,IAAI,EAAE,CAAC;IACf,4EAA4E;IAC5E,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAkBD,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,8mCAUkC,CAAC;AAYnE,qEAAqE;AACrE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE9B,CAAC;AAEH,KAAK,UAAU,GAAG,sBAAsB,CAAC;AAEzC,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChF;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AAID,0EAA0E;AAC1E,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAC,CAAsB;IAC1C,OAAO,CAAC,UAAU,CAAC,CAAsB;gBAE7B,OAAO,GAAE,mBAAwB;IAQ7C,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,aAAa;IAOrB,sFAAsF;IAEhF,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA8ErE"}

package/dist/shared/hyde/lens.inferrer.js

@@ -7,17 +7,13 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-/**
- * Lens Inferrer Agent: analyzes source text (intent or query) with optional
- * profile context and infers 1-N search lenses, each tagged with a target corpus.
- * Replaces the hardcoded HydeStrategy enum and regex-based selectStrategiesFromQuery.
- */
 import { HumanMessage, SystemMessage } from '@langchain/core/messages';
 import { z } from 'zod';
-import { Timed } from "../observability/performance.js";
-import { protocolLogger } from '../observability/protocol.logger.js';
 import { createStructuredModel } from "../agent/model.config.js";
 import { invokeWithAbortSignal } from "../agent/model-signal.js";
+import { protocolLogger } from '../observability/protocol.logger.js';
+import { Timed } from "../observability/performance.js";
+import { HydeSourceFrameSchema, sanitizeHydeSourceFrame } from './hyde.frame.js';
 const SYSTEM_PROMPT = `You analyze goals and search queries to identify the most relevant perspectives for finding matching people in a professional network.
 
 For each perspective you identify, specify:
@@ -33,37 +29,60 @@ Guidelines:
 - Use "profiles" when looking for a type of person (expert, advisor, leader). Use "intents" when looking for a complementary goal or need (someone raising, someone hiring, someone seeking collaboration). Use "premises" when looking for someone whose identity, values, or worldview aligns — stable traits rather than transient goals.
 - Always include at least one "profiles" perspective when the source describes a need that a specific type of professional could fulfill. Most intents benefit from profile-based discovery.
 - LOCATION AWARENESS: When the source text or user context mentions a specific location (city, region, country), incorporate it into lens descriptions. For example, "investors in San Francisco" should produce a lens like "SF-based early-stage investor" rather than just "early-stage investor". This helps the hypothetical document generator produce location-specific search documents, improving retrieval quality.`;
+/** Source-grounded system prompt used only by frame extraction. */
+export const FRAME_SYSTEM_PROMPT = `You extract a source-grounded frame for semantic retrieval from sourceText alone.
+
+Source-frame rules:
+- Extract evidence ONLY from sourceText.
+- Every frame element must include an evidence field copied as an exact substring of sourceText.
+- sourceRoles describe roles held or offered by the source side.
+- sourceRoles and counterpartRoles MUST use generic lower-case role labels only (for example, "founder", "investor", or "technical advisor"). Never put a person, organization, product, location, time, number, credential, or exclusivity detail in a role label.
+- counterpartRoles describe reciprocal or complementary target roles. A generic role may be inferred, but its evidence must be an exact sourceText span that supports the inference.
+- hardConstraints contain only explicit constraints and classify each as location, time, numeric, credential, organization, exclusivity, or other.
+- namedEntities contain only proper names explicitly present in sourceText and classify each as person, organization, product, location, event, or other.
+- domainVocabulary contains source domain terms worth preserving.`;
+const lensSchema = z.object({
+    label: z.string().describe('Specific description of the search perspective'),
+    corpus: z.enum(['profiles', 'intents', 'premises']).describe('Search user profiles, user intents, or user premises (identity/values)'),
+    reasoning: z.string().describe('Why this perspective is relevant'),
+});
 const responseFormat = z.object({
-    lenses: z.array(z.object({
-        label: z.string().describe('Specific description of the search perspective'),
-        corpus: z.enum(['profiles', 'intents', 'premises']).describe('Search user profiles, user intents, or user premises (identity/values)'),
-        reasoning: z.string().describe('Why this perspective is relevant'),
-    })).min(1).max(5).describe('Inferred search lenses'),
+    lenses: z.array(lensSchema).min(1).max(5).describe('Inferred search lenses'),
+});
+/** Structured-output schema used only by source-frame extraction. */
+export const FrameResponseSchema = z.object({
+    sourceFrame: HydeSourceFrameSchema,
 });
 const logger = protocolLogger("LensInferrer");
-/**
- * Infers search lenses from source text and optional profile context.
- * Each lens represents a search perspective tagged with a target corpus
- * (profiles or intents) for downstream HyDE document generation.
- */
+/** Infers search lenses from source text and optional profile context. */
 export class LensInferrer {
-    constructor() {
-        this.model = createStructuredModel("lensInferrer", responseFormat, {
+    constructor(options = {}) {
+        // Preserve legacy construction behavior in production. Frame-only model
+        // injection deliberately avoids constructing a provider-backed legacy model.
+        this.legacyModel = options.legacyModel
+            ?? (options.frameModel ? undefined : createStructuredModel("lensInferrer", responseFormat, { name: "lens_inferrer" }));
+        this.frameModel = options.frameModel;
+    }
+    getLegacyModel() {
+        this.legacyModel ?? (this.legacyModel = createStructuredModel("lensInferrer", responseFormat, {
             name: "lens_inferrer",
-        });
+        }));
+        return this.legacyModel;
     }
-    /**
-     * Infer search lenses from source text and optional profile context.
-     *
-     * @param input - Source text, optional profile context, optional max lenses
-     * @returns Array of inferred lenses with corpus tags; empty array on failure
-     */
+    getFrameModel() {
+        this.frameModel ?? (this.frameModel = createStructuredModel("lensInferrer", FrameResponseSchema, {
+            name: "lens_inferrer_frame_v1",
+        }));
+        return this.frameModel;
+    }
+    /** Infer search lenses while preserving the legacy path unless explicitly enabled. */
     async infer(input) {
-        const { sourceText, profileContext, maxLenses = 3 } = input;
+        const { sourceText, profileContext, maxLenses = 3, frameConstrained = false } = input;
         logger.verbose('Inferring lenses', {
             sourceTextLength: sourceText.length,
             hasProfileContext: !!profileContext,
             maxLenses,
+            frameConstrained,
         });
         let humanPrompt = `Identify up to ${maxLenses} search perspectives for finding relevant matches.\n\nSource: "${sourceText}"`;
         if (profileContext) {
@@ -73,20 +92,56 @@ export class LensInferrer {
             new SystemMessage(SYSTEM_PROMPT),
             new HumanMessage(humanPrompt),
         ];
-        try {
-            const result = await invokeWithAbortSignal(this.model, messages);
-            const parsed = responseFormat.parse(result);
-            const lenses = parsed.lenses.slice(0, maxLenses);
-            logger.verbose('Lenses inferred', {
-                count: lenses.length,
-                lenses: lenses.map(l => ({ label: l.label, corpus: l.corpus })),
-            });
-            return { lenses };
+        if (!frameConstrained) {
+            try {
+                const result = await invokeWithAbortSignal(this.getLegacyModel(), messages);
+                const parsed = responseFormat.parse(result);
+                const lenses = parsed.lenses.slice(0, maxLenses);
+                logger.verbose('Lenses inferred', {
+                    count: lenses.length,
+                    lenses: lenses.map(l => ({ label: l.label, corpus: l.corpus })),
+                });
+                return { lenses };
+            }
+            catch (error) {
+                logger.error('Lens inference failed', { error });
+                return { lenses: [] };
+            }
         }
-        catch (error) {
-            logger.error('Lens inference failed', { error });
+        const frameMessages = [
+            new SystemMessage(FRAME_SYSTEM_PROMPT),
+            new HumanMessage(`Extract the source frame.\n\nSource: "${sourceText}"`),
+        ];
+        const lensPromise = (async () => {
+            const result = await invokeWithAbortSignal(this.getLegacyModel(), messages);
+            return responseFormat.parse(result).lenses.slice(0, maxLenses);
+        })();
+        const framePromise = (async () => {
+            const result = await invokeWithAbortSignal(this.getFrameModel(), frameMessages);
+            const parsed = FrameResponseSchema.parse(result);
+            return sanitizeHydeSourceFrame(sourceText, parsed.sourceFrame);
+        })();
+        const [lensResult, frameResult] = await Promise.allSettled([lensPromise, framePromise]);
+        if (lensResult.status === 'rejected') {
+            logger.error('Lens inference failed', { error: lensResult.reason });
             return { lenses: [] };
         }
+        const lenses = lensResult.value;
+        logger.verbose('Frame-constrained lenses inferred', { count: lenses.length });
+        if (frameResult.status === 'rejected') {
+            logger.error('Source frame extraction failed', { error: frameResult.reason });
+            return {
+                lenses,
+                sourceFrame: {
+                    sourceRoles: [],
+                    counterpartRoles: [],
+                    hardConstraints: [],
+                    namedEntities: [],
+                    domainVocabulary: [],
+                },
+            };
+        }
+        return { lenses, sourceFrame: frameResult.value };
     }
 }
 __decorate([

package/dist/shared/hyde/lens.inferrer.js.map

@@ -1 +1 @@
-{"version":3,"file":"lens.inferrer.js","sourceRoot":"/","sources":["shared/hyde/lens.inferrer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Lens Inferrer Agent: analyzes source text (intent or query) with optional\n * profile context and infers 1-N search lenses, each tagged with a target corpus.\n * Replaces the hardcoded HydeStrategy enum and regex-based selectStrategiesFromQuery.\n */\nimport { HumanMessage, SystemMessage } from '@langchain/core/messages';\nimport { z } from 'zod';\nimport { Timed } from \"../observability/performance.js\";\nimport { protocolLogger } from '../observability/protocol.logger.js';\nimport { createStructuredModel } from \"../agent/model.config.js\";\nimport { invokeWithAbortSignal } from \"../agent/model-signal.js\";\n\nexport type HydeTargetCorpus = 'profiles' | 'intents' | 'premises';\n\n/** A single inferred lens — a search perspective the LLM decided is relevant. */\nexport interface Lens {\n  /** Free-text description (e.g. \"crypto infrastructure VC\"). */\n  label: string;\n  /** Which vector index to search: user profiles or user intents. */\n  corpus: HydeTargetCorpus;\n  /** Why this perspective is relevant (for logging/trace). */\n  reasoning: string;\n}\n\nexport interface LensInferenceInput {\n  /** Intent payload or search query. */\n  sourceText: string;\n  /** User's profile summary for domain context (optional). */\n  profileContext?: string;\n  /** Maximum number of lenses to infer (default 3). */\n  maxLenses?: number;\n}\n\nexport interface LensInferenceOutput {\n  lenses: Lens[];\n}\n\nconst SYSTEM_PROMPT = `You analyze goals and search queries to identify the most relevant perspectives for finding matching people in a professional network.\n\nFor each perspective you identify, specify:\n1. A clear, specific description of who or what to search for\n2. Whether to search \"profiles\" (user bios, expertise, backgrounds), \"intents\" (stated goals, needs, aspirations), or \"premises\" (identity assertions, values, worldview)\n3. A brief reason why this perspective is relevant\n\nGuidelines:\n- Be specific and domain-aware. \"early-stage crypto infrastructure investor\" is better than \"investor\".\n- Consider both sides: who can help the person AND whose goals complement theirs.\n- When user context is provided, tailor perspectives to their domain (e.g. a DePIN founder searching for \"investors\" needs crypto-native infra investors specifically).\n- Generate only perspectives that add distinct search value — don't repeat similar angles.\n- Use \"profiles\" when looking for a type of person (expert, advisor, leader). Use \"intents\" when looking for a complementary goal or need (someone raising, someone hiring, someone seeking collaboration). Use \"premises\" when looking for someone whose identity, values, or worldview aligns — stable traits rather than transient goals.\n- Always include at least one \"profiles\" perspective when the source describes a need that a specific type of professional could fulfill. Most intents benefit from profile-based discovery.\n- LOCATION AWARENESS: When the source text or user context mentions a specific location (city, region, country), incorporate it into lens descriptions. For example, \"investors in San Francisco\" should produce a lens like \"SF-based early-stage investor\" rather than just \"early-stage investor\". This helps the hypothetical document generator produce location-specific search documents, improving retrieval quality.`;\n\nconst responseFormat = z.object({\n  lenses: z.array(z.object({\n    label: z.string().describe('Specific description of the search perspective'),\n    corpus: z.enum(['profiles', 'intents', 'premises']).describe('Search user profiles, user intents, or user premises (identity/values)'),\n    reasoning: z.string().describe('Why this perspective is relevant'),\n  })).min(1).max(5).describe('Inferred search lenses'),\n});\n\nconst logger = protocolLogger(\"LensInferrer\");\n\n/**\n * Infers search lenses from source text and optional profile context.\n * Each lens represents a search perspective tagged with a target corpus\n * (profiles or intents) for downstream HyDE document generation.\n */\nexport class LensInferrer {\n  private model = createStructuredModel(\"lensInferrer\", responseFormat, {\n    name: \"lens_inferrer\",\n  });\n\n  /**\n   * Infer search lenses from source text and optional profile context.\n   *\n   * @param input - Source text, optional profile context, optional max lenses\n   * @returns Array of inferred lenses with corpus tags; empty array on failure\n   */\n  @Timed()\n  async infer(input: LensInferenceInput): Promise<LensInferenceOutput> {\n    const { sourceText, profileContext, maxLenses = 3 } = input;\n\n    logger.verbose('Inferring lenses', {\n      sourceTextLength: sourceText.length,\n      hasProfileContext: !!profileContext,\n      maxLenses,\n    });\n\n    let humanPrompt = `Identify up to ${maxLenses} search perspectives for finding relevant matches.\\n\\nSource: \"${sourceText}\"`;\n\n    if (profileContext) {\n      humanPrompt += `\\n\\nUser context: ${profileContext}`;\n    }\n\n    const messages = [\n      new SystemMessage(SYSTEM_PROMPT),\n      new HumanMessage(humanPrompt),\n    ];\n\n    try {\n      const result = await invokeWithAbortSignal(this.model, messages);\n      const parsed = responseFormat.parse(result);\n      const lenses = parsed.lenses.slice(0, maxLenses);\n\n      logger.verbose('Lenses inferred', {\n        count: lenses.length,\n        lenses: lenses.map(l => ({ label: l.label, corpus: l.corpus })),\n      });\n\n      return { lenses };\n    } catch (error: unknown) {\n      logger.error('Lens inference failed', { error });\n      return { lenses: [] };\n    }\n  }\n}\n"]}
+{"version":3,"file":"lens.inferrer.js","sourceRoot":"/","sources":["shared/hyde/lens.inferrer.ts"],"names":[],"mappings":";;;;;;;;;AAMA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAwB,MAAM,iBAAiB,CAAC;AA+BvG,MAAM,aAAa,GAAG;;;;;;;;;;;;;;8ZAcwY,CAAC;AAE/Z,mEAAmE;AACnE,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;kEAU+B,CAAC;AAEnE,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IAC5E,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,wEAAwE,CAAC;IACtI,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;CACnE,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;CAC7E,CAAC,CAAC;AAEH,qEAAqE;AACrE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,WAAW,EAAE,qBAAqB;CACnC,CAAC,CAAC;AAcH,MAAM,MAAM,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAE9C,0EAA0E;AAC1E,MAAM,OAAO,YAAY;IAIvB,YAAY,UAA+B,EAAE;QAC3C,wEAAwE;QACxE,6EAA6E;QAC7E,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW;eACjC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,cAAc,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;QACzH,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACvC,CAAC;IAEO,cAAc;QACpB,IAAI,CAAC,WAAW,KAAhB,IAAI,CAAC,WAAW,GAAK,qBAAqB,CAAC,cAAc,EAAE,cAAc,EAAE;YACzE,IAAI,EAAE,eAAe;SACtB,CAAC,EAAC;QACH,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAEO,aAAa;QACnB,IAAI,CAAC,UAAU,KAAf,IAAI,CAAC,UAAU,GAAK,qBAAqB,CAAC,cAAc,EAAE,mBAAmB,EAAE;YAC7E,IAAI,EAAE,wBAAwB;SAC/B,CAAC,EAAC;QACH,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,sFAAsF;IAEhF,AAAN,KAAK,CAAC,KAAK,CAAC,KAAyB;QACnC,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,GAAG,CAAC,EAAE,gBAAgB,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;QAEtF,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE;YACjC,gBAAgB,EAAE,UAAU,CAAC,MAAM;YACnC,iBAAiB,EAAE,CAAC,CAAC,cAAc;YACnC,SAAS;YACT,gBAAgB;SACjB,CAAC,CAAC;QAEH,IAAI,WAAW,GAAG,kBAAkB,SAAS,kEAAkE,UAAU,GAAG,CAAC;QAE7H,IAAI,cAAc,EAAE,CAAC;YACnB,WAAW,IAAI,qBAAqB,cAAc,EAAE,CAAC;QACvD,CAAC;QAED,MAAM,QAAQ,GAAG;YACf,IAAI,aAAa,CAAC,aAAa,CAAC;YAChC,IAAI,YAAY,CAAC,WAAW,CAAC;SAC9B,CAAC;QAEF,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,QAAQ,CAAC,CAAC;gBAC5E,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;gBAEjD,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE;oBAChC,KAAK,EAAE,MAAM,CAAC,MAAM;oBACpB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;iBAChE,CAAC,CAAC;gBAEH,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBACjD,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YACxB,CAAC;QACH,CAAC;QAED,MAAM,aAAa,GAAG;YACpB,IAAI,aAAa,CAAC,mBAAmB,CAAC;YACtC,IAAI,YAAY,CAAC,yCAAyC,UAAU,GAAG,CAAC;SACzE,CAAC;QACF,MAAM,WAAW,GAAG,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,QAAQ,CAAC,CAAC;YAC5E,OAAO,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACjE,CAAC,CAAC,EAAE,CAAC;QACL,MAAM,YAAY,GAAG,CAAC,KAAK,IAAI,EAAE;YAC/B,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,aAAa,CAAC,CAAC;YAChF,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACjD,OAAO,uBAAuB,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QACjE,CAAC,CAAC,EAAE,CAAC;QACL,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;QAExF,IAAI,UAAU,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACrC,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YACpE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACxB,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,mCAAmC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAE9E,IAAI,WAAW,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACtC,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9E,OAAO;gBACL,MAAM;gBACN,WAAW,EAAE;oBACX,WAAW,EAAE,EAAE;oBACf,gBAAgB,EAAE,EAAE;oBACpB,eAAe,EAAE,EAAE;oBACnB,aAAa,EAAE,EAAE;oBACjB,gBAAgB,EAAE,EAAE;iBACrB;aACF,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC;IACpD,CAAC;CACF;AA9EO;IADL,KAAK,EAAE;;;;yCA8EP","sourcesContent":["/**\n * Lens Inferrer Agent: analyzes source text (intent or query) with optional\n * profile context and infers 1-N search lenses, each tagged with a target corpus.\n * Replaces the hardcoded HydeStrategy enum and regex-based selectStrategiesFromQuery.\n */\nimport type { BaseLanguageModelInput } from '@langchain/core/language_models/base';\nimport { HumanMessage, SystemMessage } from '@langchain/core/messages';\nimport { z } from 'zod';\n\nimport { createStructuredModel } from \"../agent/model.config.js\";\nimport { invokeWithAbortSignal } from \"../agent/model-signal.js\";\nimport { protocolLogger } from '../observability/protocol.logger.js';\nimport { Timed } from \"../observability/performance.js\";\nimport { HydeSourceFrameSchema, sanitizeHydeSourceFrame, type HydeSourceFrame } from './hyde.frame.js';\n\nexport type HydeTargetCorpus = 'profiles' | 'intents' | 'premises';\n\n/** A single inferred lens — a search perspective the LLM decided is relevant. */\nexport interface Lens {\n  /** Free-text description (e.g. \"crypto infrastructure VC\"). */\n  label: string;\n  /** Which vector index to search: user profiles or user intents. */\n  corpus: HydeTargetCorpus;\n  /** Why this perspective is relevant (for logging/trace). */\n  reasoning: string;\n}\n\nexport interface LensInferenceInput {\n  /** Intent payload or search query. */\n  sourceText: string;\n  /** User's profile summary for domain context (optional). */\n  profileContext?: string;\n  /** Maximum number of lenses to infer (default 3). */\n  maxLenses?: number;\n  /** Use the source-grounded frame-v1 inference path. */\n  frameConstrained?: boolean;\n}\n\nexport interface LensInferenceOutput {\n  lenses: Lens[];\n  /** Sanitized source frame, present only for frame-constrained inference. */\n  sourceFrame?: HydeSourceFrame;\n}\n\nconst SYSTEM_PROMPT = `You analyze goals and search queries to identify the most relevant perspectives for finding matching people in a professional network.\n\nFor each perspective you identify, specify:\n1. A clear, specific description of who or what to search for\n2. Whether to search \"profiles\" (user bios, expertise, backgrounds), \"intents\" (stated goals, needs, aspirations), or \"premises\" (identity assertions, values, worldview)\n3. A brief reason why this perspective is relevant\n\nGuidelines:\n- Be specific and domain-aware. \"early-stage crypto infrastructure investor\" is better than \"investor\".\n- Consider both sides: who can help the person AND whose goals complement theirs.\n- When user context is provided, tailor perspectives to their domain (e.g. a DePIN founder searching for \"investors\" needs crypto-native infra investors specifically).\n- Generate only perspectives that add distinct search value — don't repeat similar angles.\n- Use \"profiles\" when looking for a type of person (expert, advisor, leader). Use \"intents\" when looking for a complementary goal or need (someone raising, someone hiring, someone seeking collaboration). Use \"premises\" when looking for someone whose identity, values, or worldview aligns — stable traits rather than transient goals.\n- Always include at least one \"profiles\" perspective when the source describes a need that a specific type of professional could fulfill. Most intents benefit from profile-based discovery.\n- LOCATION AWARENESS: When the source text or user context mentions a specific location (city, region, country), incorporate it into lens descriptions. For example, \"investors in San Francisco\" should produce a lens like \"SF-based early-stage investor\" rather than just \"early-stage investor\". This helps the hypothetical document generator produce location-specific search documents, improving retrieval quality.`;\n\n/** Source-grounded system prompt used only by frame extraction. */\nexport const FRAME_SYSTEM_PROMPT = `You extract a source-grounded frame for semantic retrieval from sourceText alone.\n\nSource-frame rules:\n- Extract evidence ONLY from sourceText.\n- Every frame element must include an evidence field copied as an exact substring of sourceText.\n- sourceRoles describe roles held or offered by the source side.\n- sourceRoles and counterpartRoles MUST use generic lower-case role labels only (for example, \"founder\", \"investor\", or \"technical advisor\"). Never put a person, organization, product, location, time, number, credential, or exclusivity detail in a role label.\n- counterpartRoles describe reciprocal or complementary target roles. A generic role may be inferred, but its evidence must be an exact sourceText span that supports the inference.\n- hardConstraints contain only explicit constraints and classify each as location, time, numeric, credential, organization, exclusivity, or other.\n- namedEntities contain only proper names explicitly present in sourceText and classify each as person, organization, product, location, event, or other.\n- domainVocabulary contains source domain terms worth preserving.`;\n\nconst lensSchema = z.object({\n  label: z.string().describe('Specific description of the search perspective'),\n  corpus: z.enum(['profiles', 'intents', 'premises']).describe('Search user profiles, user intents, or user premises (identity/values)'),\n  reasoning: z.string().describe('Why this perspective is relevant'),\n});\n\nconst responseFormat = z.object({\n  lenses: z.array(lensSchema).min(1).max(5).describe('Inferred search lenses'),\n});\n\n/** Structured-output schema used only by source-frame extraction. */\nexport const FrameResponseSchema = z.object({\n  sourceFrame: HydeSourceFrameSchema,\n});\n\ntype ModelInput = BaseLanguageModelInput;\n\n/** Minimal structured model contract used for deterministic injection in tests. */\nexport interface LensStructuredModel {\n  invoke(input: ModelInput, config?: { signal?: AbortSignal }): Promise<unknown>;\n}\n\nexport interface LensInferrerOptions {\n  legacyModel?: LensStructuredModel;\n  frameModel?: LensStructuredModel;\n}\n\nconst logger = protocolLogger(\"LensInferrer\");\n\n/** Infers search lenses from source text and optional profile context. */\nexport class LensInferrer {\n  private legacyModel?: LensStructuredModel;\n  private frameModel?: LensStructuredModel;\n\n  constructor(options: LensInferrerOptions = {}) {\n    // Preserve legacy construction behavior in production. Frame-only model\n    // injection deliberately avoids constructing a provider-backed legacy model.\n    this.legacyModel = options.legacyModel\n      ?? (options.frameModel ? undefined : createStructuredModel(\"lensInferrer\", responseFormat, { name: \"lens_inferrer\" }));\n    this.frameModel = options.frameModel;\n  }\n\n  private getLegacyModel(): LensStructuredModel {\n    this.legacyModel ??= createStructuredModel(\"lensInferrer\", responseFormat, {\n      name: \"lens_inferrer\",\n    });\n    return this.legacyModel;\n  }\n\n  private getFrameModel(): LensStructuredModel {\n    this.frameModel ??= createStructuredModel(\"lensInferrer\", FrameResponseSchema, {\n      name: \"lens_inferrer_frame_v1\",\n    });\n    return this.frameModel;\n  }\n\n  /** Infer search lenses while preserving the legacy path unless explicitly enabled. */\n  @Timed()\n  async infer(input: LensInferenceInput): Promise<LensInferenceOutput> {\n    const { sourceText, profileContext, maxLenses = 3, frameConstrained = false } = input;\n\n    logger.verbose('Inferring lenses', {\n      sourceTextLength: sourceText.length,\n      hasProfileContext: !!profileContext,\n      maxLenses,\n      frameConstrained,\n    });\n\n    let humanPrompt = `Identify up to ${maxLenses} search perspectives for finding relevant matches.\\n\\nSource: \"${sourceText}\"`;\n\n    if (profileContext) {\n      humanPrompt += `\\n\\nUser context: ${profileContext}`;\n    }\n\n    const messages = [\n      new SystemMessage(SYSTEM_PROMPT),\n      new HumanMessage(humanPrompt),\n    ];\n\n    if (!frameConstrained) {\n      try {\n        const result = await invokeWithAbortSignal(this.getLegacyModel(), messages);\n        const parsed = responseFormat.parse(result);\n        const lenses = parsed.lenses.slice(0, maxLenses);\n\n        logger.verbose('Lenses inferred', {\n          count: lenses.length,\n          lenses: lenses.map(l => ({ label: l.label, corpus: l.corpus })),\n        });\n\n        return { lenses };\n      } catch (error: unknown) {\n        logger.error('Lens inference failed', { error });\n        return { lenses: [] };\n      }\n    }\n\n    const frameMessages = [\n      new SystemMessage(FRAME_SYSTEM_PROMPT),\n      new HumanMessage(`Extract the source frame.\\n\\nSource: \"${sourceText}\"`),\n    ];\n    const lensPromise = (async () => {\n      const result = await invokeWithAbortSignal(this.getLegacyModel(), messages);\n      return responseFormat.parse(result).lenses.slice(0, maxLenses);\n    })();\n    const framePromise = (async () => {\n      const result = await invokeWithAbortSignal(this.getFrameModel(), frameMessages);\n      const parsed = FrameResponseSchema.parse(result);\n      return sanitizeHydeSourceFrame(sourceText, parsed.sourceFrame);\n    })();\n    const [lensResult, frameResult] = await Promise.allSettled([lensPromise, framePromise]);\n\n    if (lensResult.status === 'rejected') {\n      logger.error('Lens inference failed', { error: lensResult.reason });\n      return { lenses: [] };\n    }\n\n    const lenses = lensResult.value;\n    logger.verbose('Frame-constrained lenses inferred', { count: lenses.length });\n\n    if (frameResult.status === 'rejected') {\n      logger.error('Source frame extraction failed', { error: frameResult.reason });\n      return {\n        lenses,\n        sourceFrame: {\n          sourceRoles: [],\n          counterpartRoles: [],\n          hardConstraints: [],\n          namedEntities: [],\n          domainVocabulary: [],\n        },\n      };\n    }\n\n    return { lenses, sourceFrame: frameResult.value };\n  }\n}\n"]}

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

@@ -88,6 +88,10 @@ export interface OpportunitySignal {
     detail?: string;
     /** Optional source question for reversible pool-preference provenance. */
     questionId?: string;
+    /** Recipient provenance for pool-discriminator signals. */
+    recipientUserId?: string;
+    /** Intent-pool provenance for pool-discriminator signals. */
+    intentId?: string;
 }
 /** LLM-generated interpretation of an opportunity's category and confidence. */
 export interface OpportunityInterpretation {
@@ -264,6 +268,10 @@ export interface SimilarIntentSearchOptions {
  * Represents a user's membership in an index with full details.
  * Used for displaying network memberships in chat (index_query).
  */
+export interface ActiveNetworkMembershipPair {
+    userId: string;
+    networkId: string;
+}
 export interface NetworkMembership {
     /** Unique identifier of the index */
     networkId: string;
@@ -457,6 +465,14 @@ export interface Opportunity {
     expiresAt: Date | null;
     metadata?: Record<string, unknown> | null;
 }
+export interface OpportunityNetworkEligibility {
+    /** User whose active memberships define the discovery boundary. */
+    ownerUserId: string;
+    /** Request/intent-authorized networks after the latest graph-side recomputation. */
+    allowedNetworkIds: string[];
+    /** When present, each actor network must remain assigned to this intent through commit. */
+    triggerIntentId?: string;
+}
 export interface CreateOpportunityData {
     detection: OpportunityDetection;
     actors: OpportunityActor[];
@@ -706,6 +722,12 @@ export interface Database {
      * @returns The membership or null if not found
      */
     getNetworkMembership(networkId: string, userId: string): Promise<NetworkMembership | null>;
+    /**
+     * Return only requested user/network pairs backed by a live membership row
+     * and a non-deleted network. Permissions are intentionally not filtered:
+     * personal-network contacts are valid discovery participants.
+     */
+    getActiveNetworkMembershipPairs(pairs: ActiveNetworkMembershipPair[]): Promise<ActiveNetworkMembershipPair[]>;
     /**
      * Get index by ID with core fields. Used for opportunity presentation and context rendering.
      */
@@ -1082,6 +1104,17 @@ export interface Database {
      * @returns The created opportunity
      */
     createOpportunity(data: CreateOpportunityData): Promise<Opportunity>;
+    /**
+     * Atomically create only while every actor still has an active membership on
+     * the actor's network. Implementations lock the membership rows through the
+     * insert commit so concurrent removal cannot race opportunity creation.
+     */
+    createOpportunityIfNetworkEligible?(data: CreateOpportunityData, eligibility: OpportunityNetworkEligibility): Promise<Opportunity | null>;
+    /**
+     * Atomically update status only while the supplied participant anchors remain
+     * active. Used for discovery dedup reactivation races.
+     */
+    updateOpportunityStatusIfNetworkEligible?(id: string, status: OpportunityStatus, actors: OpportunityActor[], eligibility: OpportunityNetworkEligibility): Promise<Opportunity | null>;
     /**
      * Get a single opportunity by ID.
      *
@@ -1127,6 +1160,12 @@ export interface Database {
      * @returns Array of opportunities
      */
     getOpportunitiesForUser(userId: string, options?: OpportunityQueryOptions): Promise<Opportunity[]>;
+    /**
+     * Get the live candidate pool created exactly by one intent and visible to
+     * its recipient. Unlike selected-intent reads, this never falls back to an
+     * actor.intent match.
+     */
+    getLivePoolOpportunitiesForIntent(recipientUserId: string, intentId: string): Promise<Opportunity[]>;
     /**
      * Get opportunities in an index (for index admins).
      *
@@ -1178,6 +1217,11 @@ export interface Database {
         created: Opportunity;
         expired: Opportunity[];
     }>;
+    /** Eligibility-locked variant of create+expire for discovery persistence. */
+    createOpportunityAndExpireIdsIfNetworkEligible?(data: CreateOpportunityData, expireIds: string[], eligibility: OpportunityNetworkEligibility): Promise<{
+        created: Opportunity;
+        expired: Opportunity[];
+    } | null>;
     /**
      * Check if an opportunity already exists between the given actors in the index (deduplication).
      *
@@ -1737,7 +1781,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' | 'getOpportunity' | 'getOpportunitiesByIds' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'getOpportunitiesForUser' | 'updateOpportunityStatus' | 'updateOpportunityActorApproval' | 'stampOpportunityActorAction' | 'getOrCreateDM' | 'getHydeDocument' | 'getHydeDocumentsForSource' | 'saveHydeDocument' | 'getIntent' | 'getPublicIndexesNotJoined' | 'getUserIndexIds' | 'getAssignmentNetworkMembershipsForUser' | 'getAssignmentNetworkIdsForUser' | 'getNetworkMemberships' | 'getNetworkMembership' | 'getNetwork' | 'getNetworkWithPermissions' | 'getIntentForIndexing' | 'getNetworkMemberContext' | 'getNetworkAssignmentContext' | 'isIntentAssignedToIndex' | 'assignIntentToNetwork' | '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' | 'updateOpportunityStatusIfNetworkEligible' | 'getOpportunity' | 'getOpportunitiesByIds' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'getOpportunitiesForUser' | 'updateOpportunityStatus' | 'updateOpportunityActorApproval' | 'stampOpportunityActorAction' | 'getOrCreateDM' | 'getHydeDocument' | 'getHydeDocumentsForSource' | 'saveHydeDocument' | 'getIntent' | 'getPublicIndexesNotJoined' | 'getUserIndexIds' | 'getAssignmentNetworkMembershipsForUser' | 'getAssignmentNetworkIdsForUser' | 'getNetworkMemberships' | 'getNetworkMembership' | 'getActiveNetworkMembershipPairs' | 'getNetwork' | 'getNetworkWithPermissions' | 'getIntentForIndexing' | 'getNetworkMemberContext' | 'getNetworkAssignmentContext' | 'isIntentAssignedToIndex' | 'assignIntentToNetwork' | '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'>;
 /**
  * Database interface for Opportunity Graph operations.
  * Includes prep/scope (network membership, intents, index details), persist (create, dedupe),
@@ -1745,7 +1789,7 @@ export type ChatGraphCompositeDatabase = Pick<Database, 'getProfile' | 'getActiv
  *
  * Access layer: SystemDatabase (cross-user opportunity operations)
  */
-export type OpportunityGraphDatabase = Pick<Database, 'getProfile' | 'createOpportunity' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'getUserIndexIds' | 'getNetworkMemberships' | 'getActiveIntents' | 'getNetworkIdsForIntent' | 'getNetwork' | 'getNetworkMemberCount' | 'getIntentIndexScores' | 'getNetworkMemberContext' | 'getNetworkAssignmentContext' | 'getOpportunity' | 'getOpportunitiesForUser' | 'updateOpportunityStatus' | 'stampOpportunityActorAction' | 'updateOpportunityActorApproval' | 'isNetworkMember' | 'isIndexOwner' | 'getUser' | 'getOrCreateDM' | 'getIntent' | 'getPremisesForUser' | 'getPremisesForUserInNetworks' | 'searchPremisesBySimilarity' | 'searchPremisesBySimilarityBatch' | 'getUserContext' | 'getUserContexts' | 'searchIntentsByContextEmbedding' | 'getHydeDocumentsForSource'> & Pick<NegotiationQueries, 'getNegotiationTaskForOpportunity'>;
+export type OpportunityGraphDatabase = Pick<Database, 'getProfile' | 'createOpportunity' | 'createOpportunityIfNetworkEligible' | 'createOpportunityAndExpireIdsIfNetworkEligible' | 'updateOpportunityStatusIfNetworkEligible' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'getUserIndexIds' | 'getNetworkMemberships' | 'getActiveNetworkMembershipPairs' | 'getActiveIntents' | 'getNetworkIdsForIntent' | 'getNetwork' | 'getNetworkMemberCount' | 'getIntentIndexScores' | 'getNetworkMemberContext' | 'getNetworkAssignmentContext' | 'getOpportunity' | 'getOpportunitiesForUser' | 'updateOpportunityStatus' | 'stampOpportunityActorAction' | 'updateOpportunityActorApproval' | 'isNetworkMember' | 'isIndexOwner' | 'getUser' | 'getOrCreateDM' | 'getIntent' | 'getPremisesForUser' | 'getPremisesForUserInNetworks' | 'searchPremisesBySimilarity' | 'searchPremisesBySimilarityBatch' | 'getUserContext' | 'getUserContexts' | 'searchIntentsByContextEmbedding' | 'getHydeDocumentsForSource'> & Pick<NegotiationQueries, 'getNegotiationTaskForOpportunity'>;
 /**
  * Negotiation-specific query operations not covered by generic
  * conversation/task primitives.