@indexnetwork/protocol 14.2.2-rc.473.1 → 14.3.0-rc.475.1

package/CHANGELOG.md

@@ -20,6 +20,50 @@ went 6.7.1 → 8.0.2 with no 7.x in between because the whole 7.x line shipped a
 prereleases between the two promotions. To track every change, read `rc`; to
 pin a supported release, use `latest`.
 
+## 14.3.0 - 2026-08-16
+
+No public API change: all 443 exported symbols are byte-identical to 14.2.2.
+
+### Changed
+
+- Promoted `shared/hyde/` to a `discovery/` capability — 9 source files and 7
+  specs. HyDE owns a graph, a generator, a lens inferrer, and a validator; that
+  is discovery machinery, not shared infrastructure. It lived under `shared/`
+  because two capabilities needed it, which had made `shared/` the default home
+  for anything with more than one consumer.
+
+  `discovery/index.ts` is its sole cross-capability surface, carrying the 41
+  symbols that actually cross the boundary. `contexts` and `opportunities` now
+  reach it through that barrel; the tool composition root keeps its direct leaf
+  imports, as it is exempt by design and as a barrel import there is what caused
+  the runtime cycle in 14.2.0.
+
+- `HydeGraphFactory`, `HydeGenerator`, and `LensInferrer` are re-exported from
+  the root barrel via `discovery/index.js` rather than `contexts/index.js`, and
+  the `contexts` barrel no longer carries them. The exported names are
+  unchanged; only the internal path moved.
+
+- Declared the directions this makes explicit: `contexts → discovery`,
+  `opportunities → discovery`, and `discovery → agents` (HyDE stamps a
+  debug-metadata type onto its graph state). 25 named directions became 29.
+
+### Note
+
+The rest of the `shared/` rehoming was considered and rejected on evidence.
+`shared/assignment/` is used by `networks` *and* `premises`, and
+`shared/network/metadata.renderer` by `networks` *and* `opportunities` — so
+moving either into `networks/` would create `contexts → networks` and
+`opportunities → networks`, neither of which is an allowed direction. They are
+in `shared/` precisely because two capabilities need them and neither owns them;
+moving them would add edges to the capability graph rather than remove them.
+
+`shared/agent/` mixes the composition root with model primitives and is a
+genuine split candidate, but it has 140 importers across 15 capabilities and
+`tool.factory` is the module that produced the 14.2.0 cycle. Left alone
+deliberately. What remains under `shared/` — `interfaces/`, `observability/`,
+`schemas/`, `utils/`, and `agent/` — spans 5 to 15 capabilities each and is
+correctly neutral.
+
 ## 14.2.2 - 2026-08-16
 
 No public API change: all 443 exported symbols are byte-identical to 14.2.1.
@@ -288,6 +332,9 @@ No public API change: all 441 exported symbols are byte-identical to 13.2.0, and
 
 ## [Unreleased]
 
+### Changed
+- Move the opportunity-presentation review checklist into `src/opportunity/AGENTS.md` and repoint the `opportunity.safe-presentation.ts` and `discriminator.adjustments.ts` comments at it. Comment-only; no runtime change.
+
 ### Removed
 
 - **Breaking (14.0.0):** remove the `orchestrator` chat persona. `ORCHESTRATOR_PERSONA_ID` and `ORCHESTRATOR_PERSONA` are gone from the public API, and the orchestrator system prompt (`buildSystemContent`) and its conditional prompt-module registry are deleted. `ChatPersonaLoopBehaviors.hallucinationRecovery` is retained — it is opted into by the onboarding, signal and negotiator personas, not just the removed one.

package/dist/contexts/application/index.d.ts

@@ -51,7 +51,7 @@
  *   prompt-injection and out-of-scope risks.
  *
  * IND-545: canonical application home for participant-context orchestrators
- * previously spread across premises/, contexts/, enrichment/, and shared/hyde/.
+ * previously spread across premises/, contexts/, enrichment/, and discovery/.
  */
 export { PremiseGraphFactory } from "../../premises/premise.graph.js";
 export { PremiseDecomposer, type PremiseDecomposerOutput, type DecomposedPremise, type ExistingPremiseRef, } from "../../premises/premise.decomposer.js";
@@ -63,11 +63,11 @@ export { shouldEnrichGhostDisplayNameFromParallel, isEnrichedNameMeaningful, } f
 export { createEnrichmentTools } from "../../enrichment/enrichment.tools.js";
 export { createPremiseTools } from "../../premises/premise.tools.js";
 export { UserContextGenerator } from "../../contexts/context.generator.js";
-export { HydeGraphFactory, type HydeLensInferrerLike, type HydeGeneratorLike, type HydeValidatorLike, type HydeGraphOptions, } from "../../shared/hyde/hyde.graph.js";
-export { HydeGenerator, type HydeGeneratorOutput, type HydeGenerateInput, } from "../../shared/hyde/hyde.generator.js";
-export { LensInferrer, type LensInferenceInput, type LensInferenceOutput, FRAME_SYSTEM_PROMPT, FrameResponseSchema, } from "../../shared/hyde/lens.inferrer.js";
-export { HydeValidator, type HydeValidationDocument, type HydeValidationInput, type HydeValidationVerdict, type HydeValidationOutput, HydeValidationResponseSchema, buildHydeValidationPrompt, } from "../../shared/hyde/hyde.validator.js";
-export { computeHydeSourceTextHash, selectHydeDocumentsForGeneration } from "../../shared/hyde/hyde.documents.js";
-export { getHydeGenerationMode, type HydeGenerationMode, HYDE_FRAME_GENERATION_VERSION, } from "../../shared/hyde/hyde.env.js";
-export { HYDE_DEFAULT_CACHE_TTL, HYDE_CORPUS_PROMPTS, } from "../../shared/hyde/hyde.strategies.js";
-export { type HydeSourceFrame, HydeSourceFrameSchema, type HydeFrameRole, type HydeFrameHardConstraint, type HydeFrameNamedEntity, type HydeFrameVocabulary, HYDE_HARD_CONSTRAINT_TYPES, HYDE_NAMED_ENTITY_TYPES, } from "../../shared/hyde/hyde.frame.js";
+export { HydeGraphFactory, type HydeLensInferrerLike, type HydeGeneratorLike, type HydeValidatorLike, type HydeGraphOptions, } from "../../discovery/index.js";
+export { HydeGenerator, type HydeGeneratorOutput, type HydeGenerateInput, } from "../../discovery/index.js";
+export { LensInferrer, type LensInferenceInput, type LensInferenceOutput, FRAME_SYSTEM_PROMPT, FrameResponseSchema, } from "../../discovery/index.js";
+export { HydeValidator, type HydeValidationDocument, type HydeValidationInput, type HydeValidationVerdict, type HydeValidationOutput, HydeValidationResponseSchema, buildHydeValidationPrompt, } from "../../discovery/index.js";
+export { computeHydeSourceTextHash, selectHydeDocumentsForGeneration } from "../../discovery/index.js";
+export { getHydeGenerationMode, type HydeGenerationMode, HYDE_FRAME_GENERATION_VERSION, } from "../../discovery/index.js";
+export { HYDE_DEFAULT_CACHE_TTL, HYDE_CORPUS_PROMPTS, } from "../../discovery/index.js";
+export { type HydeSourceFrame, HydeSourceFrameSchema, type HydeFrameRole, type HydeFrameHardConstraint, type HydeFrameNamedEntity, type HydeFrameVocabulary, HYDE_HARD_CONSTRAINT_TYPES, HYDE_NAMED_ENTITY_TYPES, } from "../../discovery/index.js";

package/dist/contexts/application/index.js

@@ -51,7 +51,7 @@
  *   prompt-injection and out-of-scope risks.
  *
  * IND-545: canonical application home for participant-context orchestrators
- * previously spread across premises/, contexts/, enrichment/, and shared/hyde/.
+ * previously spread across premises/, contexts/, enrichment/, and discovery/.
  */
 // ── Premise graph ─────────────────────────────────────────────────────────────
 export { PremiseGraphFactory } from "../../premises/premise.graph.js";
@@ -72,12 +72,12 @@ export { createPremiseTools } from "../../premises/premise.tools.js";
 // ── Context synthesis ─────────────────────────────────────────────────────────
 export { UserContextGenerator } from "../../contexts/context.generator.js";
 // ── HyDE graph + service classes ─────────────────────────────────────────────
-export { HydeGraphFactory, } from "../../shared/hyde/hyde.graph.js";
-export { HydeGenerator, } from "../../shared/hyde/hyde.generator.js";
-export { LensInferrer, FRAME_SYSTEM_PROMPT, FrameResponseSchema, } from "../../shared/hyde/lens.inferrer.js";
-export { HydeValidator, HydeValidationResponseSchema, buildHydeValidationPrompt, } from "../../shared/hyde/hyde.validator.js";
+export { HydeGraphFactory, } from "../../discovery/index.js";
+export { HydeGenerator, } from "../../discovery/index.js";
+export { LensInferrer, FRAME_SYSTEM_PROMPT, FrameResponseSchema, } from "../../discovery/index.js";
+export { HydeValidator, HydeValidationResponseSchema, buildHydeValidationPrompt, } from "../../discovery/index.js";
 // ── HyDE utilities ────────────────────────────────────────────────────────────
-export { computeHydeSourceTextHash, selectHydeDocumentsForGeneration } from "../../shared/hyde/hyde.documents.js";
-export { getHydeGenerationMode, HYDE_FRAME_GENERATION_VERSION, } from "../../shared/hyde/hyde.env.js";
-export { HYDE_DEFAULT_CACHE_TTL, HYDE_CORPUS_PROMPTS, } from "../../shared/hyde/hyde.strategies.js";
-export { HydeSourceFrameSchema, HYDE_HARD_CONSTRAINT_TYPES, HYDE_NAMED_ENTITY_TYPES, } from "../../shared/hyde/hyde.frame.js";
+export { computeHydeSourceTextHash, selectHydeDocumentsForGeneration } from "../../discovery/index.js";
+export { getHydeGenerationMode, HYDE_FRAME_GENERATION_VERSION, } from "../../discovery/index.js";
+export { HYDE_DEFAULT_CACHE_TTL, HYDE_CORPUS_PROMPTS, } from "../../discovery/index.js";
+export { HydeSourceFrameSchema, HYDE_HARD_CONSTRAINT_TYPES, HYDE_NAMED_ENTITY_TYPES, } from "../../discovery/index.js";

package/dist/contexts/domain/index.d.ts

@@ -57,11 +57,11 @@
  *   in shared/agent and shared/hyde.
  *
  * IND-545: canonical home for participant-context domain contracts previously
- * spread across premises/, contexts/, enrichment/, and shared/hyde/.
+ * spread across premises/, contexts/, enrichment/, and discovery/.
  * Legacy paths remain as compatibility re-exports pointing here.
  */
 export { PremiseGraphState } from "../../premises/premise.state.js";
 export { EnrichmentGraphState } from "../../enrichment/enrichment.state.js";
-export { HydeGraphState, type HydeDocumentState, type HydeDocumentOrigin, type HydeValidationStatus, } from "../../shared/hyde/hyde.state.js";
+export { HydeGraphState, type HydeDocumentState, type HydeDocumentOrigin, type HydeValidationStatus, } from "../../discovery/index.js";
 export type { UserContextInput, IncrementalContextInput, GlobalContextInput, GlobalIncrementalContextInput, UserContextResult, } from "../../contexts/context.generator.js";
 export type { PremiseAssertion, PremiseProvenance, PremiseAnalysis, PremiseValidity, PremiseRecord, } from "../../shared/interfaces/database.interface.js";

package/dist/contexts/domain/index.js

@@ -57,7 +57,7 @@
  *   in shared/agent and shared/hyde.
  *
  * IND-545: canonical home for participant-context domain contracts previously
- * spread across premises/, contexts/, enrichment/, and shared/hyde/.
+ * spread across premises/, contexts/, enrichment/, and discovery/.
  * Legacy paths remain as compatibility re-exports pointing here.
  */
 // ── Premise graph state ───────────────────────────────────────────────────────
@@ -65,4 +65,4 @@ export { PremiseGraphState } from "../../premises/premise.state.js";
 // ── Enrichment graph state ────────────────────────────────────────────────────
 export { EnrichmentGraphState } from "../../enrichment/enrichment.state.js";
 // ── HyDE graph state and document types ──────────────────────────────────────
-export { HydeGraphState, } from "../../shared/hyde/hyde.state.js";
+export { HydeGraphState, } from "../../discovery/index.js";

package/dist/contexts/index.d.ts

@@ -9,5 +9,5 @@
  * Supersedes the capabilities/participant-context.facade.ts + public/ pair; the
  * export list is the union of the facades it replaces, so the contract is unchanged.
  */
-export { createEnrichmentTools, createPremiseTools, EnrichmentGraphFactory, PremiseGraphFactory, UserContextGenerator, HydeGraphFactory, HydeGenerator, LensInferrer, } from "./application/index.js";
+export { createEnrichmentTools, createPremiseTools, EnrichmentGraphFactory, PremiseGraphFactory, UserContextGenerator, } from "./application/index.js";
 export type { EnrichmentToolDeps, PremiseToolDeps, } from "./ports/participant-context.tools.port.js";

package/dist/contexts/index.js

@@ -9,6 +9,4 @@
  * Supersedes the capabilities/participant-context.facade.ts + public/ pair; the
  * export list is the union of the facades it replaces, so the contract is unchanged.
  */
-export { createEnrichmentTools, createPremiseTools, EnrichmentGraphFactory, PremiseGraphFactory, UserContextGenerator, 
-// HyDE — participant-context technology binding
-HydeGraphFactory, HydeGenerator, LensInferrer, } from "./application/index.js";
+export { createEnrichmentTools, createPremiseTools, EnrichmentGraphFactory, PremiseGraphFactory, UserContextGenerator, } from "./application/index.js";

package/dist/{shared/hyde → discovery}/hyde.documents.d.ts

@@ -1,4 +1,4 @@
-import type { HydeDocument } from '../interfaces/database.interface.js';
+import type { HydeDocument } from '../shared/interfaces/database.interface.js';
 import { type HydeGenerationMode } from './hyde.env.js';
 /** Hash source text without persisting the source itself in frame metadata. */
 export declare function computeHydeSourceTextHash(sourceText: string): string;

package/dist/{shared/hyde → discovery}/hyde.generator.js

@@ -9,10 +9,10 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 import { HumanMessage, SystemMessage } from '@langchain/core/messages';
 import { z } from 'zod';
-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 { createStructuredModel } from "../shared/agent/model.config.js";
+import { invokeWithAbortSignal } from "../shared/agent/model-signal.js";
+import { protocolLogger } from '../shared/observability/protocol.logger.js';
+import { Timed } from "../shared/observability/performance.js";
 import { HYDE_CORPUS_PROMPTS } from './hyde.strategies.js';
 const logger = protocolLogger("HydeGenerator");
 const SYSTEM_PROMPT = `You are a Hypothetical Document Generator for semantic search.

package/dist/{shared/hyde → discovery}/hyde.graph.d.ts

@@ -1,7 +1,7 @@
-import type { DebugMetaAgent } from '../../chat/chat-streaming.types.js';
-import type { HydeCache } from '../interfaces/cache.interface.js';
-import type { HydeGraphDatabase } from '../interfaces/database.interface.js';
-import type { EmbeddingGenerator } from '../interfaces/embedder.interface.js';
+import type { DebugMetaAgent } from '../agents/index.js';
+import type { HydeCache } from '../shared/interfaces/cache.interface.js';
+import type { HydeGraphDatabase } from '../shared/interfaces/database.interface.js';
+import type { EmbeddingGenerator } from '../shared/interfaces/embedder.interface.js';
 import { type HydeGenerationMode } from './hyde.env.js';
 import { type HydeSourceFrame } from './hyde.frame.js';
 import type { HydeGenerateInput, HydeGeneratorOutput } from './hyde.generator.js';
@@ -36,7 +36,7 @@ export declare class HydeGraphFactory {
     constructor(database: HydeGraphDatabase, embedder: EmbeddingGenerator, cache: HydeCache, inferrer: HydeLensInferrerLike, generator: HydeGeneratorLike, options?: HydeGraphOptions);
     createGraph(): import("@langchain/langgraph").CompiledStateGraph<{
         sourceType: "intent" | "context" | "query";
-        sourceId: import("../interfaces/database.interface.js").Id<"users"> | import("../interfaces/database.interface.js").Id<"intents"> | undefined;
+        sourceId: import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | undefined;
         sourceText: string;
         profileContext: string | undefined;
         maxLenses: number;
@@ -52,7 +52,7 @@ export declare class HydeGraphFactory {
         agentTimings: DebugMetaAgent[];
     }, {
         sourceType?: "intent" | "context" | "query" | undefined;
-        sourceId?: import("../interfaces/database.interface.js").Id<"users"> | import("../interfaces/database.interface.js").Id<"intents"> | import("@langchain/langgraph").OverwriteValue<import("../interfaces/database.interface.js").Id<"users"> | import("../interfaces/database.interface.js").Id<"intents"> | undefined> | undefined;
+        sourceId?: import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | import("@langchain/langgraph").OverwriteValue<import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | undefined> | undefined;
         sourceText?: string | undefined;
         profileContext?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         maxLenses?: number | import("@langchain/langgraph").OverwriteValue<number> | undefined;
@@ -72,7 +72,7 @@ export declare class HydeGraphFactory {
             (): import("@langchain/langgraph").LastValue<"intent" | "context" | "query">;
             Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
         };
-        sourceId: import("@langchain/langgraph").BaseChannel<import("../interfaces/database.interface.js").Id<"users"> | import("../interfaces/database.interface.js").Id<"intents"> | undefined, import("../interfaces/database.interface.js").Id<"users"> | import("../interfaces/database.interface.js").Id<"intents"> | import("@langchain/langgraph").OverwriteValue<import("../interfaces/database.interface.js").Id<"users"> | import("../interfaces/database.interface.js").Id<"intents"> | undefined> | undefined, unknown>;
+        sourceId: import("@langchain/langgraph").BaseChannel<import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | undefined, import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | import("@langchain/langgraph").OverwriteValue<import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | undefined> | undefined, unknown>;
         sourceText: {
             (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
             (): import("@langchain/langgraph").LastValue<string>;
@@ -96,7 +96,7 @@ export declare class HydeGraphFactory {
             (): import("@langchain/langgraph").LastValue<"intent" | "context" | "query">;
             Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
         };
-        sourceId: import("@langchain/langgraph").BaseChannel<import("../interfaces/database.interface.js").Id<"users"> | import("../interfaces/database.interface.js").Id<"intents"> | undefined, import("../interfaces/database.interface.js").Id<"users"> | import("../interfaces/database.interface.js").Id<"intents"> | import("@langchain/langgraph").OverwriteValue<import("../interfaces/database.interface.js").Id<"users"> | import("../interfaces/database.interface.js").Id<"intents"> | undefined> | undefined, unknown>;
+        sourceId: import("@langchain/langgraph").BaseChannel<import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | undefined, import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | import("@langchain/langgraph").OverwriteValue<import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | undefined> | undefined, unknown>;
         sourceText: {
             (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
             (): import("@langchain/langgraph").LastValue<string>;

package/dist/{shared/hyde → discovery}/hyde.graph.js

@@ -6,10 +6,10 @@
  */
 import { createHash } from 'crypto';
 import { END, START, StateGraph } from '@langchain/langgraph';
-import { getAbortSignalConfig } from '../agent/model-signal.js';
-import { protocolLogger } from '../observability/protocol.logger.js';
-import { timed } from '../observability/performance.js';
-import { requestContext } from "../observability/request-context.js";
+import { getAbortSignalConfig } from '../shared/agent/model-signal.js';
+import { protocolLogger } from '../shared/observability/protocol.logger.js';
+import { timed } from '../shared/observability/performance.js';
+import { requestContext } from "../shared/observability/request-context.js";
 import { computeHydeSourceTextHash } from './hyde.documents.js';
 import { getHydeGenerationMode, HYDE_FRAME_GENERATION_VERSION } from './hyde.env.js';
 import { sanitizeHydeSourceFrame } from './hyde.frame.js';

package/dist/{shared/hyde → discovery}/hyde.state.d.ts

@@ -2,10 +2,10 @@
  * HyDE Graph state: cache-aware hypothetical document generation.
  * Used by the HyDE graph for infer_lenses → check_cache → generate_missing → embed → cache_results.
  */
-import type { Id } from '../interfaces/database.interface.js';
+import type { Id } from '../shared/interfaces/database.interface.js';
 import type { Lens, HydeTargetCorpus } from './lens.inferrer.js';
 import type { HydeSourceFrame } from './hyde.frame.js';
-import type { DebugMetaAgent } from '../../chat/chat-streaming.types.js';
+import type { DebugMetaAgent } from '../agents/index.js';
 export type HydeDocumentOrigin = 'cache' | 'db' | 'generated';
 export type HydeValidationStatus = 'valid' | 'invalid' | 'failed_open';
 /** Single HyDE document (text + embedding) for one lens. */

package/dist/{shared/hyde → discovery}/hyde.validator.js

@@ -1,7 +1,7 @@
 import { HumanMessage, SystemMessage } from '@langchain/core/messages';
 import { z } from 'zod';
-import { createStructuredModel } from '../agent/model.config.js';
-import { invokeWithAbortSignal } from '../agent/model-signal.js';
+import { createStructuredModel } from '../shared/agent/model.config.js';
+import { invokeWithAbortSignal } from '../shared/agent/model-signal.js';
 /** Structured-output schema for a single batch validation response. */
 export const HydeValidationResponseSchema = z.object({
     verdicts: z.array(z.object({

package/dist/discovery/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * discovery — the capability's sole cross-capability surface.
+ *
+ * HyDE (Hypothetical Document Embeddings) is discovery machinery, not shared
+ * infrastructure: it owns a graph, a generator, a lens inferrer, and a
+ * validator. It lived under shared/ because two capabilities needed it, which
+ * made shared/ the default home for anything with more than one consumer.
+ *
+ * Anything outside this capability imports from here and nowhere else.
+ */
+export { computeHydeSourceTextHash, selectHydeDocumentsForGeneration, } from "./hyde.documents.js";
+export { HYDE_FRAME_GENERATION_VERSION, getHydeGenerationMode, } from "./hyde.env.js";
+export type { HydeGenerationMode, } from "./hyde.env.js";
+export { HYDE_HARD_CONSTRAINT_TYPES, HYDE_NAMED_ENTITY_TYPES, HydeSourceFrameSchema, } from "./hyde.frame.js";
+export type { HydeFrameHardConstraint, HydeFrameNamedEntity, HydeFrameRole, HydeFrameVocabulary, HydeSourceFrame, } from "./hyde.frame.js";
+export { HydeGenerator, } from "./hyde.generator.js";
+export type { HydeGenerateInput, HydeGeneratorOutput, } from "./hyde.generator.js";
+export { HydeGraphFactory, } from "./hyde.graph.js";
+export type { HydeGeneratorLike, HydeGraphOptions, HydeLensInferrerLike, HydeValidatorLike, } from "./hyde.graph.js";
+export { HydeGraphState, } from "./hyde.state.js";
+export type { HydeDocumentOrigin, HydeDocumentState, HydeValidationStatus, } from "./hyde.state.js";
+export { HYDE_CORPUS_PROMPTS, HYDE_DEFAULT_CACHE_TTL, } from "./hyde.strategies.js";
+export { HydeValidationResponseSchema, HydeValidator, buildHydeValidationPrompt, } from "./hyde.validator.js";
+export type { HydeValidationDocument, HydeValidationInput, HydeValidationOutput, HydeValidationVerdict, } from "./hyde.validator.js";
+export { FRAME_SYSTEM_PROMPT, FrameResponseSchema, LensInferrer, } from "./lens.inferrer.js";
+export type { HydeTargetCorpus, Lens, LensInferenceInput, LensInferenceOutput, } from "./lens.inferrer.js";

package/dist/discovery/index.js

@@ -0,0 +1,19 @@
+/**
+ * discovery — the capability's sole cross-capability surface.
+ *
+ * HyDE (Hypothetical Document Embeddings) is discovery machinery, not shared
+ * infrastructure: it owns a graph, a generator, a lens inferrer, and a
+ * validator. It lived under shared/ because two capabilities needed it, which
+ * made shared/ the default home for anything with more than one consumer.
+ *
+ * Anything outside this capability imports from here and nowhere else.
+ */
+export { computeHydeSourceTextHash, selectHydeDocumentsForGeneration, } from "./hyde.documents.js";
+export { HYDE_FRAME_GENERATION_VERSION, getHydeGenerationMode, } from "./hyde.env.js";
+export { HYDE_HARD_CONSTRAINT_TYPES, HYDE_NAMED_ENTITY_TYPES, HydeSourceFrameSchema, } from "./hyde.frame.js";
+export { HydeGenerator, } from "./hyde.generator.js";
+export { HydeGraphFactory, } from "./hyde.graph.js";
+export { HydeGraphState, } from "./hyde.state.js";
+export { HYDE_CORPUS_PROMPTS, HYDE_DEFAULT_CACHE_TTL, } from "./hyde.strategies.js";
+export { HydeValidationResponseSchema, HydeValidator, buildHydeValidationPrompt, } from "./hyde.validator.js";
+export { FRAME_SYSTEM_PROMPT, FrameResponseSchema, LensInferrer, } from "./lens.inferrer.js";

package/dist/{shared/hyde → discovery}/lens.inferrer.js

@@ -9,10 +9,10 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 import { HumanMessage, SystemMessage } from '@langchain/core/messages';
 import { z } from 'zod';
-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 { createStructuredModel } from "../shared/agent/model.config.js";
+import { invokeWithAbortSignal } from "../shared/agent/model-signal.js";
+import { protocolLogger } from '../shared/observability/protocol.logger.js';
+import { Timed } from "../shared/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.
 

package/dist/index.d.ts

@@ -40,7 +40,7 @@ export { SIGNAL_PERSONA_ID, SIGNAL_PERSONA, SIGNAL_NEW_SIGNAL_KICKOFF, SIGNAL_TO
 export { REPORTER_PERSONA_ID, REPORTER_PERSONA, REPORTER_BRIEFING_KICKOFF, REPORTER_TOOL_NAMES, createReporterTools, filterReporterTools, narrowReporterTools, } from "./agents/index.js";
 export { ONBOARDING_PERSONA_ID, ONBOARDING_PERSONA, ONBOARDING_PROFILE_KICKOFF, ONBOARDING_TOOL_NAMES, createOnboardingTools, filterOnboardingTools, narrowOnboardingTools, } from "./agents/index.js";
 export { RadarGraphFactory } from "./opportunities/index.js";
-export { HydeGraphFactory } from "./contexts/index.js";
+export { HydeGraphFactory } from "./discovery/index.js";
 export { NetworkGraphFactory } from "./networks/index.js";
 export { NetworkMembershipGraphFactory } from "./networks/index.js";
 export { IntentGraphFactory } from "./intents/index.js";
@@ -61,7 +61,7 @@ export { UserContextGenerator } from "./contexts/index.js";
 export { ChatTitleGenerator } from "./agents/index.js";
 export { ChatInterruptClassifier } from "./agents/index.js";
 export { ChatSummarizer } from "./agents/index.js";
-export { HydeGenerator } from "./contexts/index.js";
+export { HydeGenerator } from "./discovery/index.js";
 export { SuggestionGenerator } from "./agents/index.js";
 export { generateInviteMessage } from "./contacts/index.js";
 export { IntentIndexer } from "./intents/index.js";
@@ -71,7 +71,7 @@ export type { IntakePack, IntakePackInput, IntakePackQuestion, IntakePackQuestio
 export { SignalIntakeOrchestrator, answerLabel, FALLBACK_WHO_QUESTION, FALLBACK_BRING_QUESTION, } from "./intents/index.js";
 export type { IntakeAnswer, IntakeRound, FollowUpPlan, FollowUpPlanInput, SynthesisInput, SynthesisResult, } from "./intents/index.js";
 export { normalizeIntentDescription } from "./intents/index.js";
-export { LensInferrer } from "./contexts/index.js";
+export { LensInferrer } from "./discovery/index.js";
 export { NegotiationInsightsGenerator } from "./negotiations/index.js";
 export type { NegotiationDigest } from "./negotiations/index.js";
 export { IndexNegotiator } from "./negotiations/index.js";

package/dist/index.js

@@ -35,7 +35,7 @@ export { SIGNAL_PERSONA_ID, SIGNAL_PERSONA, SIGNAL_NEW_SIGNAL_KICKOFF, SIGNAL_TO
 export { REPORTER_PERSONA_ID, REPORTER_PERSONA, REPORTER_BRIEFING_KICKOFF, REPORTER_TOOL_NAMES, createReporterTools, filterReporterTools, narrowReporterTools, } from "./agents/index.js";
 export { ONBOARDING_PERSONA_ID, ONBOARDING_PERSONA, ONBOARDING_PROFILE_KICKOFF, ONBOARDING_TOOL_NAMES, createOnboardingTools, filterOnboardingTools, narrowOnboardingTools, } from "./agents/index.js";
 export { RadarGraphFactory } from "./opportunities/index.js";
-export { HydeGraphFactory } from "./contexts/index.js";
+export { HydeGraphFactory } from "./discovery/index.js";
 export { NetworkGraphFactory } from "./networks/index.js";
 export { NetworkMembershipGraphFactory } from "./networks/index.js";
 export { IntentGraphFactory } from "./intents/index.js";
@@ -53,14 +53,14 @@ export { UserContextGenerator } from "./contexts/index.js";
 export { ChatTitleGenerator } from "./agents/index.js";
 export { ChatInterruptClassifier } from "./agents/index.js";
 export { ChatSummarizer } from "./agents/index.js";
-export { HydeGenerator } from "./contexts/index.js";
+export { HydeGenerator } from "./discovery/index.js";
 export { SuggestionGenerator } from "./agents/index.js";
 export { generateInviteMessage } from "./contacts/index.js";
 export { IntentIndexer } from "./intents/index.js";
 export { SignalIntakePackGenerator, normalizeIntakePack } from "./intents/index.js";
 export { SignalIntakeOrchestrator, answerLabel, FALLBACK_WHO_QUESTION, FALLBACK_BRING_QUESTION, } from "./intents/index.js";
 export { normalizeIntentDescription } from "./intents/index.js";
-export { LensInferrer } from "./contexts/index.js";
+export { LensInferrer } from "./discovery/index.js";
 export { NegotiationInsightsGenerator } from "./negotiations/index.js";
 export { IndexNegotiator } from "./negotiations/index.js";
 export { NegotiationScreener } from "./negotiations/index.js";

package/dist/opportunities/application/opportunity.evaluator.d.ts

@@ -1,6 +1,6 @@
 import type { Runnable } from "@langchain/core/runnables";
 import { z } from "zod";
-import type { Lens } from "../../shared/hyde/lens.inferrer.js";
+import type { Lens } from "../../discovery/index.js";
 import type { OpportunityStatus } from "../../shared/interfaces/database.interface.js";
 import type { OpportunityEvidence } from '../../shared/schemas/network-assignment.schema.js';
 declare const OpportunitySchema: z.ZodObject<{

package/dist/opportunities/application/opportunity.graph.d.ts

@@ -1153,7 +1153,7 @@ export declare class OpportunityGraphFactory {
                 initialStatus: OpportunityStatus;
                 negotiationContinuation?: import("../../shared/interfaces/database.interface.js").NegotiationContinuationExecution;
                 limit?: number;
-                lenses?: import("../../shared/hyde/lens.inferrer.js").Lens[];
+                lenses?: import("../../discovery/lens.inferrer.js").Lens[];
                 hydeDescription?: string;
                 existingOpportunities?: string;
                 conversationId?: string;
@@ -1177,7 +1177,7 @@ export declare class OpportunityGraphFactory {
                 initialStatus: OpportunityStatus;
                 negotiationContinuation?: import("../../shared/interfaces/database.interface.js").NegotiationContinuationExecution;
                 limit?: number;
-                lenses?: import("../../shared/hyde/lens.inferrer.js").Lens[];
+                lenses?: import("../../discovery/lens.inferrer.js").Lens[];
                 hydeDescription?: string;
                 existingOpportunities?: string;
                 conversationId?: string;

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

@@ -16,8 +16,8 @@ import { OpportunityGraphState } from '../domain/opportunity.state.js';
 import { OpportunityEvaluator } from './opportunity.evaluator.js';
 import { IntentIndexer } from '../../intents/index.js';
 import { getModelName } from '../../shared/agent/model.config.js';
-import { selectHydeDocumentsForGeneration } from '../../shared/hyde/hyde.documents.js';
-import { getHydeGenerationMode } from '../../shared/hyde/hyde.env.js';
+import { selectHydeDocumentsForGeneration } from '../../discovery/index.js';
+import { getHydeGenerationMode } from '../../discovery/index.js';
 import { validateOpportunityActors } from '../domain/opportunity.utils.js';
 import { safeFallbackSummary } from '../domain/opportunity.safe-presentation.js';
 import { hasUnsupportedOpportunityClaim } from '../../shared/utils/claim-safety.js';

package/dist/opportunities/discriminator/discriminator.adjustments.js

@@ -13,7 +13,7 @@
  *   dismissal-driven reversal removes them.
  * - `detail` carries the template chip text built from the user's OWN answer
  *   ("Hands-on builders vs advisors: you chose Advisor") — never LLM
- *   reasoning (review-opportunity-presentation).
+ *   reasoning (see `packages/protocol/src/opportunity/AGENTS.md`).
  */
 import { POOL_ADJUSTMENT_FACTOR_OTHER, POOL_ADJUSTMENT_FACTOR_UNKNOWN, POOL_ADJUSTMENT_FLOOR } from "./discriminator.env.js";
 /** Reads valid adjustments, optionally narrowed to one recipient + intent. */

package/dist/opportunities/domain/opportunity.safe-presentation.d.ts

@@ -16,8 +16,8 @@
  * Surfaces choose *policy* (send a sanitized fallback vs skip entirely) via
  * `allowFallback`; they no longer choose (or forget) sanitization steps.
  *
- * See `.agents/skills/review-opportunity-presentation/SKILL.md` for the review
- * checklist this module exists to satisfy.
+ * See `packages/protocol/src/opportunity/AGENTS.md` for the review checklist this
+ * module exists to satisfy.
  */
 /** Default max length for fallback summaries (matches presenter internal fallback). */
 export declare const SAFE_FALLBACK_MAX_CHARS = 300;

package/dist/opportunities/domain/opportunity.safe-presentation.js

@@ -16,8 +16,8 @@
  * Surfaces choose *policy* (send a sanitized fallback vs skip entirely) via
  * `allowFallback`; they no longer choose (or forget) sanitization steps.
  *
- * See `.agents/skills/review-opportunity-presentation/SKILL.md` for the review
- * checklist this module exists to satisfy.
+ * See `packages/protocol/src/opportunity/AGENTS.md` for the review checklist this
+ * module exists to satisfy.
  */
 import { truncateAtBoundary, viewerCentricCardSummary } from "./opportunity.presentation.js";
 import { stripUnsupportedOpportunityClaims } from "../../shared/utils/claim-safety.js";

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

@@ -5,7 +5,7 @@
  * With lens-based HyDE, strategy selection is handled automatically by the
  * LensInferrer agent. This file provides corpus-to-role mapping for opportunity actors.
  */
-import type { HydeTargetCorpus } from '../../shared/hyde/lens.inferrer.js';
+import type { HydeTargetCorpus } from '../../discovery/index.js';
 /** Actor roles in the opportunity model (agent / patient / peer). */
 export type OpportunityActorRole = 'agent' | 'patient' | 'peer';
 /** Result of mapping a corpus to source and candidate roles. */

package/dist/premises/premise.graph.d.ts

@@ -98,7 +98,7 @@ export declare class PremiseGraphFactory {
             message?: string;
         } | undefined> | undefined;
         agentTimings?: DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<DebugMetaAgent[]> | undefined;
-    }, "index" | "query" | "__start__" | "persist" | "embed" | "analyze" | "dedupe", {
+    }, "index" | "query" | "__start__" | "embed" | "persist" | "analyze" | "dedupe", {
         userId: {
             (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
             (): import("@langchain/langgraph").LastValue<string>;

package/dist/shared/agent/tool.factory.js

@@ -2,9 +2,9 @@ import { tool } from "@langchain/core/tools";
 import { IntentGraphFactory } from "../../intents/application/intent.graph.js";
 import { EnrichmentGraphFactory } from "../../enrichment/enrichment.graph.js";
 import { OpportunityGraphFactory } from "../../opportunities/index.js";
-import { HydeGraphFactory } from "../hyde/hyde.graph.js";
-import { HydeGenerator } from "../hyde/hyde.generator.js";
-import { LensInferrer } from "../hyde/lens.inferrer.js";
+import { HydeGraphFactory } from "../../discovery/hyde.graph.js";
+import { HydeGenerator } from "../../discovery/hyde.generator.js";
+import { LensInferrer } from "../../discovery/lens.inferrer.js";
 import { NetworkGraphFactory, NetworkMembershipGraphFactory, IntentNetworkGraphFactory } from "../../networks/index.js";
 import { IntentIndexer } from "../../intents/application/intent.indexer.js";
 import { NegotiationGraphFactory } from "../../negotiations/index.js";

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

@@ -1,4 +1,4 @@
-export type { Lens, HydeTargetCorpus } from '../hyde/lens.inferrer.js';
+export type { Lens, HydeTargetCorpus } from '../../discovery/lens.inferrer.js';
 /** A single lens embedding ready for search. */
 export interface LensEmbedding {
     /** Free-text lens label (e.g. "crypto infrastructure VC"). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "14.2.2-rc.473.1",
+  "version": "14.3.0-rc.475.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",