@indexnetwork/protocol 10.1.3-rc.453.1 → 11.0.1-rc.455.1

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

@@ -31,7 +31,7 @@ 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 { DISCOVERY_EVALUATOR_MIN_SCORE_DEFAULT, discoveryEvaluatorMinScore, discoveryIntentMatchingEnabled, discoveryMinSimilarity, discoveryProfileMatchingEnabled, discoveryProfileSource, validateDiscoveryEvaluatorMinScore, validateDiscoveryMinSimilarity } 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';
@@ -208,7 +208,9 @@ export class OpportunityGraphFactory {
      */
     queueNegotiateExisting, 
     /** Host-side P4b stamper. Omitted by manual/introducer/enrichment roots. */
-    stampNewbornOpportunities) {
+    stampNewbornOpportunities, 
+    /** Eval/test-only overrides; production composition resolves from environment. */
+    thresholdOverrides) {
         this.database = database;
         this.embedder = embedder;
         this.hydeGenerator = hydeGenerator;
@@ -218,8 +220,15 @@ export class OpportunityGraphFactory {
         this.agentDispatcher = agentDispatcher;
         this.queueNegotiateExisting = queueNegotiateExisting;
         this.stampNewbornOpportunities = stampNewbornOpportunities;
+        this.thresholdOverrides = thresholdOverrides;
     }
     createGraph() {
+        const retrievalMinSimilarity = this.thresholdOverrides?.retrievalMinSimilarity === undefined
+            ? discoveryMinSimilarity()
+            : validateDiscoveryMinSimilarity(this.thresholdOverrides.retrievalMinSimilarity);
+        const evaluatorMinScore = this.thresholdOverrides?.evaluatorMinScore === undefined
+            ? discoveryEvaluatorMinScore()
+            : validateDiscoveryEvaluatorMinScore(this.thresholdOverrides.evaluatorMinScore);
         const evaluatorAgent = this.optionalEvaluator ?? new OpportunityEvaluator();
         // ═══════════════════════════════════════════════════════════════
         // NODE DEFINITIONS
@@ -743,8 +752,6 @@ export class OpportunityGraphFactory {
                     // (The options.limit controls final output, not search pool)
                     const limitPerStrategy = 30;
                     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.
@@ -903,7 +910,7 @@ export class OpportunityGraphFactory {
                                 excludeUserId: discoveryUserId,
                                 limitPerStrategy,
                                 limit: perIndexLimit,
-                                minScore,
+                                minScore: retrievalMinSimilarity,
                                 corpusGating,
                             });
                             if (intentResultsEnabled)
@@ -1011,6 +1018,7 @@ export class OpportunityGraphFactory {
                                 networkIds: targetNetworkIds,
                                 excludeUserId: discoveryUserId,
                                 limitPerSource: PREMISE_MATCH_LIMIT_PER_SOURCE,
+                                minScore: retrievalMinSimilarity,
                             })
                             : (await Promise.all(sourcePremises.map(async (sp) => {
                                 const results = await self.database.searchPremisesBySimilarity({
@@ -1018,6 +1026,7 @@ export class OpportunityGraphFactory {
                                     networkIds: targetNetworkIds,
                                     excludeUserId: discoveryUserId,
                                     limit: PREMISE_MATCH_LIMIT_PER_SOURCE,
+                                    minScore: retrievalMinSimilarity,
                                 });
                                 return results.map((r) => ({ ...r, sourcePremiseId: sp.premiseId }));
                             }))).flat();
@@ -1090,7 +1099,7 @@ export class OpportunityGraphFactory {
                                     excludeUserId: discoveryUserId,
                                     limitPerStrategy: limitPerStrategy,
                                     limit: 20,
-                                    minScore,
+                                    minScore: retrievalMinSimilarity,
                                     corpusGating,
                                 });
                                 for (const r of results.filter(r => r.type === 'intent')) {
@@ -1114,7 +1123,7 @@ export class OpportunityGraphFactory {
                                     networkIds: [ctx.networkId],
                                     excludeUserId: discoveryUserId,
                                     limit: 20,
-                                    minScore: minScore,
+                                    minScore: retrievalMinSimilarity,
                                 });
                                 for (const r of results) {
                                     contextCandidates.push(withCandidateEvidence({
@@ -1169,7 +1178,7 @@ export class OpportunityGraphFactory {
                                 networkIds: [ctx.networkId],
                                 excludeUserId: discoveryUserId,
                                 limit: 20,
-                                minScore,
+                                minScore: retrievalMinSimilarity,
                             });
                             for (const r of results) {
                                 contextCandidates.push(withCandidateEvidence({
@@ -1302,7 +1311,7 @@ export class OpportunityGraphFactory {
                             excludeUserId: discoveryUserId,
                             limitPerStrategy,
                             limit: perIndexLimit,
-                            minScore,
+                            minScore: retrievalMinSimilarity,
                             corpusGating,
                         });
                         if (intentResultsEnabled)
@@ -1692,8 +1701,9 @@ export class OpportunityGraphFactory {
                             return evidenceByEntityKey.get(keys[0]);
                         return undefined;
                     }
-                    // Lower default threshold to 50 for better recall
-                    const minScore = state.options.minScore ?? 50;
+                    const minScore = state.targetUserId
+                        ? DISCOVERY_EVALUATOR_MIN_SCORE_DEFAULT
+                        : evaluatorMinScore;
                     const evaluatorSignalConfig = getAbortSignalConfig();
                     const evaluator = typeof evaluatorAgent.invokeEntityBundle === 'function'
                         ? evaluatorAgent
@@ -1883,15 +1893,17 @@ export class OpportunityGraphFactory {
                     });
                     // Build detailed trace entries for each evaluated candidate
                     // Threshold filter trace: how many candidates in this batch were above/below similarity threshold
-                    const aboveThreshold = batchToEvaluate.filter(c => c.similarity >= 0.40).length;
+                    const aboveThreshold = batchToEvaluate.filter((candidate) => candidate.similarity >= retrievalMinSimilarity).length;
                     const belowThreshold = batchToEvaluate.length - aboveThreshold;
                     traceEntries.push({
                         node: "threshold_filter",
-                        detail: `${aboveThreshold} above 0.40, ${belowThreshold} below (batch of ${batchToEvaluate.length})`,
+                        detail: `${aboveThreshold} above ${retrievalMinSimilarity}, ${belowThreshold} below (batch of ${batchToEvaluate.length})`,
                         data: {
                             aboveThreshold,
                             belowThreshold,
-                            minScore: 0.40,
+                            minScore: retrievalMinSimilarity,
+                            retrievalMinSimilarity,
+                            evaluatorMinScore: minScore,
                             batchSize: batchToEvaluate.length,
                         },
                     });

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

@@ -1,3 +1,9 @@
+export declare const DISCOVERY_MIN_SIMILARITY_DEFAULT = 0.3;
+export declare const DISCOVERY_EVALUATOR_MIN_SCORE_DEFAULT = 50;
+export declare function validateDiscoveryMinSimilarity(value: number): number;
+export declare function validateDiscoveryEvaluatorMinScore(value: number): number;
+export declare function discoveryMinSimilarity(): number;
+export declare function discoveryEvaluatorMinScore(): number;
 /** Data types allowed to participate in opportunity matching. */
 export type DiscoveryMatchType = 'intent' | 'profile';
 /** Test hook: clear warn-once state so each test observes warnings. */

package/dist/opportunity/discovery.env.js

@@ -21,6 +21,36 @@
  */
 import { protocolLogger } from '../shared/observability/protocol.logger.js';
 const envLog = protocolLogger('Discovery:env');
+export const DISCOVERY_MIN_SIMILARITY_DEFAULT = 0.30;
+export const DISCOVERY_EVALUATOR_MIN_SCORE_DEFAULT = 50;
+const DECIMAL_VALUE = /^[+]?(?:\d+(?:\.\d*)?|\.\d+)$/;
+function validateThreshold(name, value, max) {
+    if (!Number.isFinite(value) || value < 0 || value > max) {
+        throw new Error(`${name} must be a finite decimal between 0 and ${max} (inclusive)`);
+    }
+    return value;
+}
+function readThreshold(raw, name, fallback, max) {
+    if (raw === undefined || raw.trim() === '')
+        return fallback;
+    const normalized = raw.trim();
+    if (!DECIMAL_VALUE.test(normalized)) {
+        throw new Error(`${name} must be a finite decimal between 0 and ${max} (inclusive)`);
+    }
+    return validateThreshold(name, Number(normalized), max);
+}
+export function validateDiscoveryMinSimilarity(value) {
+    return validateThreshold('DISCOVERY_MIN_SIMILARITY', value, 1);
+}
+export function validateDiscoveryEvaluatorMinScore(value) {
+    return validateThreshold('DISCOVERY_EVALUATOR_MIN_SCORE', value, 100);
+}
+export function discoveryMinSimilarity() {
+    return readThreshold(process.env.DISCOVERY_MIN_SIMILARITY, 'DISCOVERY_MIN_SIMILARITY', DISCOVERY_MIN_SIMILARITY_DEFAULT, 1);
+}
+export function discoveryEvaluatorMinScore() {
+    return readThreshold(process.env.DISCOVERY_EVALUATOR_MIN_SCORE, 'DISCOVERY_EVALUATOR_MIN_SCORE', DISCOVERY_EVALUATOR_MIN_SCORE_DEFAULT, 100);
+}
 const VALID_TOKENS = new Set(['intent', 'profile']);
 const BOTH = new Set(['intent', 'profile']);
 /** Tokens/values already warned about (warn-once per process). */

package/dist/opportunity/discriminator/discriminator.adjustments.d.ts

@@ -1,4 +1,4 @@
-import type { QuestionPoolDiscriminator } from "../../shared/schemas/question.schema.js";
+import type { QuestionPoolDiscriminator } from "../../questions/domain/question.schema.js";
 /** Recipient and intent provenance that scopes one pool preference. */
 export interface PoolAdjustmentProvenance {
     recipientUserId: string;

package/dist/opportunity/discriminator/discriminator.push.d.ts

@@ -1,4 +1,4 @@
-import type { QuestionPoolSnapshot } from "../../shared/schemas/question.schema.js";
+import type { QuestionPoolSnapshot } from "../../questions/domain/question.schema.js";
 /** Maximum raw intent-title characters included in a proactive DM line. */
 export declare const POOL_QUESTION_PUSH_TITLE_MAX_CHARS = 80;
 /** Stable identity for one pool refresh cycle. Chained alternates retain it. */

package/dist/opportunity/discriminator/discriminator.question.d.ts

@@ -8,7 +8,7 @@
  * produced (and evidence-verified) at mining time, so synthesis is pure,
  * auditable, and cheap to re-run for interview-mode chaining.
  */
-import type { Question, QuestionPoolDiscriminator, QuestionPoolSnapshot } from "../../shared/schemas/question.schema.js";
+import type { Question, QuestionPoolDiscriminator, QuestionPoolSnapshot } from "../../questions/domain/question.schema.js";
 import type { ScoredDiscriminator } from "./discriminator.types.js";
 /** Fixed option appended to every pool question — the no-preference escape. */
 export declare const BOTH_MATTER_LABEL = "Both matter";

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

@@ -118,8 +118,6 @@ export interface OpportunityGraphOptions {
     negotiationContinuation?: NegotiationContinuationExecution;
     /** Initial status for created opportunities (default: 'pending') */
     initialStatus?: OpportunityStatus;
-    /** Minimum score threshold (default: 50) */
-    minScore?: number;
     /** Maximum opportunities to return (default: 20) */
     limit?: number;
     /** Pre-inferred lenses (if not provided, lens inference runs automatically in HyDE graph) */
@@ -178,7 +176,7 @@ export declare const OpportunityGraphState: import("@langchain/langgraph").Annot
      *
      * Defaults to 'create' for backward compatibility.
      */
-    operationMode: import("@langchain/langgraph").BaseChannel<"delete" | "send" | "update" | "create" | "create_introduction" | "continue_discovery" | "read" | "negotiate_existing" | "approve_introduction", "delete" | "send" | "update" | "create" | "create_introduction" | "continue_discovery" | "read" | "negotiate_existing" | "approve_introduction" | import("@langchain/langgraph").OverwriteValue<"delete" | "send" | "update" | "create" | "create_introduction" | "continue_discovery" | "read" | "negotiate_existing" | "approve_introduction">, unknown>;
+    operationMode: import("@langchain/langgraph").BaseChannel<"delete" | "send" | "update" | "create" | "read" | "create_introduction" | "continue_discovery" | "negotiate_existing" | "approve_introduction", "delete" | "send" | "update" | "create" | "read" | "create_introduction" | "continue_discovery" | "negotiate_existing" | "approve_introduction" | import("@langchain/langgraph").OverwriteValue<"delete" | "send" | "update" | "create" | "read" | "create_introduction" | "continue_discovery" | "negotiate_existing" | "approve_introduction">, unknown>;
     /** Introduction mode: pre-gathered entities (profiles + intents per party). */
     introductionEntities: import("@langchain/langgraph").BaseChannel<EvaluatorEntity[], EvaluatorEntity[] | import("@langchain/langgraph").OverwriteValue<EvaluatorEntity[]>, unknown>;
     /** Introduction mode: optional hint from the introducer. */

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

@@ -24,7 +24,7 @@ export { buildDiscoverySummary, toDiscoveryNegotiation, } from "../domain/negoti
 export type { NegotiationResolution } from "../domain/negotiation-summary.builder.js";
 export type { PoolCandidate, DiscriminatorMiningInput, MinedDiscriminator, ScoredDiscriminator, DiscriminatorShadowResult, } from "../discriminator/discriminator.types.js";
 export { poolQuestionsMiningMode, poolQuestionsMode, poolQuestionsPushMode, poolQuestionsStampNewborn, POOL_DISCRIMINATOR_MIN_POOL_SIZE, POOL_DISCRIMINATOR_MAX_CANDIDATES, POOL_DISCRIMINATOR_MAX_PUBLIC_CONTEXT_CHARS, POOL_QUESTION_MIN_VOI, POOL_QUESTION_MAX_PENDING_PER_INTENT, poolQuestionsRanking, POOL_RERUN_DEBOUNCE_MS, poolQuestionsVisitTrigger, POOL_VISIT_MINING_DEBOUNCE_MS, } from "../discriminator/discriminator.env.js";
-export { discoveryAllowedTypes, discoveryIntentMatchingEnabled, discoveryProfileMatchingEnabled, discoveryProfileSource, resetDiscoveryEnvWarningsForTests, } from "../discovery.env.js";
+export { DISCOVERY_EVALUATOR_MIN_SCORE_DEFAULT, DISCOVERY_MIN_SIMILARITY_DEFAULT, discoveryAllowedTypes, discoveryEvaluatorMinScore, discoveryIntentMatchingEnabled, discoveryMinSimilarity, discoveryProfileMatchingEnabled, discoveryProfileSource, resetDiscoveryEnvWarningsForTests, validateDiscoveryEvaluatorMinScore, validateDiscoveryMinSimilarity, } from "../discovery.env.js";
 export type { DiscoveryMatchType, DiscoveryProfileSource, } from "../discovery.env.js";
 export { buildPoolAdjustment, planPoolAdjustments, mergePoolAdjustment, } from "../discriminator/discriminator.adjustments.js";
 export type { PoolAdjustment, PoolAdjustmentSignal, } from "../discriminator/discriminator.adjustments.js";
@@ -38,6 +38,7 @@ export { computeRadarHealth } from "../radar/radar.health.js";
 export type { RadarHealthInput } from "../radar/radar.health.js";
 export { isIntroducerDiscoveryEnabled } from "../application/opportunity.introducer-feature.js";
 export { OpportunityGraphFactory } from "../application/opportunity.graph.js";
+export type { OpportunityGraphThresholdOverrides } from "../application/opportunity.graph.js";
 export type { StampNewbornOpportunitiesFn, StampNewbornOpportunitiesInput, } from "../application/opportunity.newborn-stamping.js";
 export { OpportunityEvaluator } from "../application/opportunity.evaluator.js";
 export type { EvaluatorInput } from "../application/opportunity.evaluator.js";

package/dist/opportunity/public/index.js

@@ -22,7 +22,7 @@ export { OPPORTUNITY_PRESENTATION_CACHE_VERSION, buildRadarCardPresentationCache
 export { buildDiscoverySummary, toDiscoveryNegotiation, } from "../domain/negotiation-summary.builder.js";
 export { poolQuestionsMiningMode, poolQuestionsMode, poolQuestionsPushMode, poolQuestionsStampNewborn, POOL_DISCRIMINATOR_MIN_POOL_SIZE, POOL_DISCRIMINATOR_MAX_CANDIDATES, POOL_DISCRIMINATOR_MAX_PUBLIC_CONTEXT_CHARS, POOL_QUESTION_MIN_VOI, POOL_QUESTION_MAX_PENDING_PER_INTENT, poolQuestionsRanking, POOL_RERUN_DEBOUNCE_MS, poolQuestionsVisitTrigger, POOL_VISIT_MINING_DEBOUNCE_MS, } from "../discriminator/discriminator.env.js";
 // discovery env accessors
-export { discoveryAllowedTypes, discoveryIntentMatchingEnabled, discoveryProfileMatchingEnabled, discoveryProfileSource, resetDiscoveryEnvWarningsForTests, } from "../discovery.env.js";
+export { DISCOVERY_EVALUATOR_MIN_SCORE_DEFAULT, DISCOVERY_MIN_SIMILARITY_DEFAULT, discoveryAllowedTypes, discoveryEvaluatorMinScore, discoveryIntentMatchingEnabled, discoveryMinSimilarity, discoveryProfileMatchingEnabled, discoveryProfileSource, resetDiscoveryEnvWarningsForTests, validateDiscoveryEvaluatorMinScore, validateDiscoveryMinSimilarity, } from "../discovery.env.js";
 export { buildPoolAdjustment, planPoolAdjustments, mergePoolAdjustment, } from "../discriminator/discriminator.adjustments.js";
 export { synthesizePoolQuestion, selectQuestionDiscriminators, toQuestionDiscriminator, BOTH_MATTER_LABEL, } from "../discriminator/discriminator.question.js";
 export { poolQuestionCycleKey, buildPoolQuestionPushMessage, } from "../discriminator/discriminator.push.js";

package/dist/participant-agents/domain/index.d.ts

@@ -14,7 +14,6 @@
  * - createAgentTools: application layer — lives in participant-agents/application.
  *
  * IND-548: canonical domain layer for the participant-agents capability.
- * Legacy path (shared/interfaces/agent.interface.ts) is a thin compatibility shim.
  */
 export type { AgentRecord, AgentTransportRecord, AgentPermissionRecord, AgentWithRelations, CreateAgentInput, CreateTransportInput, GrantPermissionInput, } from "./agent.types.js";
 export { SYSTEM_AGENT_IDS } from "./agent.types.js";

package/dist/participant-agents/index.d.ts

@@ -8,13 +8,9 @@
  * that must go through the participant-agents public surface.
  *
  * IND-548: canonical home for agent registration, permission-aware behaviour,
- * and dispatch contracts previously spread across agent/,
- * shared/interfaces/agent.interface.ts, and
- * shared/interfaces/agent-dispatcher.interface.ts.
+ * and dispatch contracts.
  *
- * Compatibility paths:
- * - shared/interfaces/agent.interface.ts — re-exports from participant-agents/domain
- *   and participant-agents/ports
+ * Compatibility path:
  * - shared/interfaces/agent-dispatcher.interface.ts — re-exports from
  *   participant-agents/ports
  */

package/dist/participant-agents/index.js

@@ -8,13 +8,9 @@
  * that must go through the participant-agents public surface.
  *
  * IND-548: canonical home for agent registration, permission-aware behaviour,
- * and dispatch contracts previously spread across agent/,
- * shared/interfaces/agent.interface.ts, and
- * shared/interfaces/agent-dispatcher.interface.ts.
+ * and dispatch contracts.
  *
- * Compatibility paths:
- * - shared/interfaces/agent.interface.ts — re-exports from participant-agents/domain
- *   and participant-agents/ports
+ * Compatibility path:
  * - shared/interfaces/agent-dispatcher.interface.ts — re-exports from
  *   participant-agents/ports
  */

package/dist/participant-agents/ports/agent.tools.port.d.ts

@@ -5,11 +5,9 @@
  * optional AgentDatabase so agent registration tools are compiled only
  * when the database adapter is wired at the composition root.
  *
- * NOTE: This type is intentionally defined inline (not derived via Pick from
- * ToolRegistryCompositionDeps in shared/agent/tool.helpers.ts) to avoid a
- * module cycle. ToolRegistryCompositionDeps imports AgentDatabase from
- * shared/interfaces/agent.interface.ts, which after IND-548 forwards to
- * participant-agents/ports — creating a cycle back here.
+ * NOTE: This type is intentionally defined inline rather than derived from
+ * ToolRegistryCompositionDeps, keeping the capability port independent from
+ * the all-capability composition contract.
  *
  * Structural equivalence with ToolRegistryCompositionDeps.agentDatabase is
  * preserved: both have type `AgentDatabase | undefined`.

package/dist/participant-agents/ports/agent.tools.port.js

@@ -5,11 +5,9 @@
  * optional AgentDatabase so agent registration tools are compiled only
  * when the database adapter is wired at the composition root.
  *
- * NOTE: This type is intentionally defined inline (not derived via Pick from
- * ToolRegistryCompositionDeps in shared/agent/tool.helpers.ts) to avoid a
- * module cycle. ToolRegistryCompositionDeps imports AgentDatabase from
- * shared/interfaces/agent.interface.ts, which after IND-548 forwards to
- * participant-agents/ports — creating a cycle back here.
+ * NOTE: This type is intentionally defined inline rather than derived from
+ * ToolRegistryCompositionDeps, keeping the capability port independent from
+ * the all-capability composition contract.
  *
  * Structural equivalence with ToolRegistryCompositionDeps.agentDatabase is
  * preserved: both have type `AgentDatabase | undefined`.

package/dist/participant-agents/ports/index.d.ts

@@ -19,8 +19,7 @@
  * - AgentToolDeps — host capabilities for registration/permission tools.
  *
  * IND-548: canonical ports surface for the participant-agents capability.
- * Legacy paths:
- *   - shared/interfaces/agent.interface.ts → re-exports AgentDatabase from here
+ * Compatibility path:
  *   - shared/interfaces/agent-dispatcher.interface.ts → re-exports from here
  */
 export type { AgentDatabase } from "./agent.repository.port.js";

package/dist/participant-agents/ports/index.js

@@ -19,8 +19,7 @@
  * - AgentToolDeps — host capabilities for registration/permission tools.
  *
  * IND-548: canonical ports surface for the participant-agents capability.
- * Legacy paths:
- *   - shared/interfaces/agent.interface.ts → re-exports AgentDatabase from here
+ * Compatibility path:
  *   - shared/interfaces/agent-dispatcher.interface.ts → re-exports from here
  */
 export {};

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

@@ -20,6 +20,5 @@
  * - Persistence/generator ports: questions/ports.
  *
  * IND-547: canonical home for question domain types.
- * Legacy path (shared/schemas/question.schema.ts) is a thin compatibility shim.
  */
 export * from "./question.schema.js";

package/dist/questions/domain/index.js

@@ -20,6 +20,5 @@
  * - Persistence/generator ports: questions/ports.
  *
  * IND-547: canonical home for question domain types.
- * Legacy path (shared/schemas/question.schema.ts) is a thin compatibility shim.
  */
 export * from "./question.schema.js";

package/dist/questions/domain/question.schema.d.ts

@@ -5,9 +5,7 @@
  * elicitation dispatch, plus internal generator, persistence, and delivery
  * envelopes used across the questions capability.
  *
- * IND-547: extracted from shared/schemas/question.schema.ts into the
- * questions domain layer.  Legacy path (shared/schemas/question.schema.ts)
- * is a thin compatibility shim pointing here.
+ * IND-547: canonical question schema in the questions domain layer.
  */
 import { z } from "zod";
 export declare const QuestionOptionSchema: z.ZodObject<{

package/dist/questions/domain/question.schema.js

@@ -5,9 +5,7 @@
  * elicitation dispatch, plus internal generator, persistence, and delivery
  * envelopes used across the questions capability.
  *
- * IND-547: extracted from shared/schemas/question.schema.ts into the
- * questions domain layer.  Legacy path (shared/schemas/question.schema.ts)
- * is a thin compatibility shim pointing here.
+ * IND-547: canonical question schema in the questions domain layer.
  */
 import { z } from "zod";
 export const QuestionOptionSchema = z.object({

package/dist/questions/index.d.ts

@@ -7,14 +7,9 @@
  * go through the questions public surface.
  *
  * IND-547: canonical home for question generation, eligibility, validation,
- * provenance, settlement policy, and continuation behaviour previously spread
- * across questioner/, shared/schemas/question.schema.ts, and
- * shared/interfaces/questioner.interface.ts.
+ * provenance, settlement policy, and continuation behaviour.
  *
  * Compatibility paths:
  * - capabilities/questions.facade.ts — re-exports from questions/public/index.js
- * - shared/schemas/question.schema.ts — re-exports from questions/domain
- * - shared/interfaces/questioner.interface.ts — re-exports from questions/ports
- * - shared/interfaces/question-generator.interface.ts — re-exports from questions/ports
  */
 export * from "./public/index.js";

package/dist/questions/index.js

@@ -7,14 +7,9 @@
  * go through the questions public surface.
  *
  * IND-547: canonical home for question generation, eligibility, validation,
- * provenance, settlement policy, and continuation behaviour previously spread
- * across questioner/, shared/schemas/question.schema.ts, and
- * shared/interfaces/questioner.interface.ts.
+ * provenance, settlement policy, and continuation behaviour.
  *
  * Compatibility paths:
  * - capabilities/questions.facade.ts — re-exports from questions/public/index.js
- * - shared/schemas/question.schema.ts — re-exports from questions/domain
- * - shared/interfaces/questioner.interface.ts — re-exports from questions/ports
- * - shared/interfaces/question-generator.interface.ts — re-exports from questions/ports
  */
 export * from "./public/index.js";

package/dist/questions/ports/question.generator.port.d.ts

@@ -11,8 +11,7 @@
  * `ProtocolDeps`/`ToolContext`. The protocol module never constructs its own
  * LLM-bound generator — callers inject one (or `undefined` to opt out).
  *
- * IND-547: canonical home — previously shared/interfaces/question-generator.interface.ts.
- * Legacy path is a thin compatibility shim pointing here.
+ * IND-547: canonical question generator port.
  */
 import type { DiscoveryQuestionInput } from "../../shared/schemas/discovery-question.schema.js";
 import type { QuestionGenerationResult } from "../domain/question.schema.js";

package/dist/questions/ports/question.persistence.port.d.ts

@@ -5,8 +5,7 @@
  * QuestionerAgent. Implementations live in the backend and are injected into
  * ProtocolDeps.
  *
- * IND-547: canonical home — previously shared/interfaces/questioner.interface.ts.
- * Legacy path is a thin compatibility shim pointing here.
+ * IND-547: canonical question persistence port.
  */
 import type { Question, QuestionMode, QuestionPurpose, QuestionStrategy, QuestionDetection, QuestionActor, QuestionAnswer, UnderspecificationType } from "../domain/question.schema.js";
 /** Shape accepted by `persist()` — everything needed to insert a question row. */

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

@@ -44,4 +44,4 @@ export { isQuestionerEnabled, isDiscoveryQuestionsEnabled, isUptakeGuardEnabled,
 export { isValidQuestionerInputContract, } from "../application/index.js";
 export type { QuestionerInput, QuestionerEnqueuePayload, QuestionerEnqueueFn, PoolDiscoveryContext, RecoveryQuestionerInput, UptakeQuestionerInput, PostStallQuestionerInput, InflightQuestionerInput, } from "../application/index.js";
 export { createQuestionerTools, createAskUserQuestionTools } from "../application/index.js";
-export type { QuestionerToolDeps, AskUserQuestionToolDeps } from "../ports/index.js";
+export type { AskUserQuestionToolDeps, ChatQuestionAnswerOutcome, ChatQuestionsHost, PersistableQuestion, PersistedQuestion, QuestionFilters, QuestionGeneratorReader, QuestionerDatabase, QuestionerToolDeps, } from "../ports/index.js";

package/dist/shared/agent/tool.helpers.d.ts

@@ -5,25 +5,25 @@ import type { UserIdentity } from "../schemas/identity.schema.js";
 import type { ChatGraphCompositeDatabase, CreateOpportunityData, NetworkMembership, UserRecord, UserDatabase, SystemDatabase, NegotiationGraphDatabase } from "../interfaces/database.interface.js";
 import type { Scraper } from "../interfaces/scraper.interface.js";
 import type { Cache, HydeCache } from "../interfaces/cache.interface.js";
-import type { IntegrationAdapter } from "../interfaces/integration.interface.js";
-import type { ContactServiceAdapter } from "../interfaces/contact.interface.js";
+import type { IntegrationAdapter } from "../../integrations/ports/index.js";
+import type { ContactServiceAdapter } from "../../contacts/ports/index.js";
 import type { ProfileEnricher } from "../interfaces/enrichment.interface.js";
 import type { IntentGraphQueue } from "../interfaces/queue.interface.js";
 import type { ChatSessionReader } from "../interfaces/chat-session.interface.js";
 import type { ChatSummaryReader } from "../interfaces/chat-summary.interface.js";
 import type { ChatMessageWriter } from "../interfaces/chat-message-writer.interface.js";
-import type { QuestionGeneratorReader } from "../interfaces/question-generator.interface.js";
+import type { QuestionGeneratorReader } from "../../questions/ports/question.generator.port.js";
 import type { NegotiationSummaryReader } from "../interfaces/negotiation-summary.interface.js";
 import type { Embedder } from "../interfaces/embedder.interface.js";
-import type { AgentDatabase } from "../interfaces/agent.interface.js";
+import type { AgentDatabase } from "../../participant-agents/ports/index.js";
 import type { NegotiationTimeoutQueue } from "../interfaces/negotiation-events.interface.js";
 import type { AgentDispatcher } from "../interfaces/agent-dispatcher.interface.js";
 import type { DeliveryLedger } from "../interfaces/delivery-ledger.interface.js";
-import type { ChatQuestionsHost, QuestionerDatabase } from "../interfaces/questioner.interface.js";
+import type { ChatQuestionsHost, QuestionerDatabase } from "../../questions/ports/index.js";
 import type { NegotiatorMemoryToolsHost } from "../interfaces/negotiator-memory.interface.js";
 import type { QuestionerEnqueueFn } from "../../questions/application/question.input.js";
 import type { PendingQuestionSummary } from "../schemas/pending-question.schema.js";
-import type { QuestionMode, QuestionPurpose } from "../schemas/question.schema.js";
+import type { QuestionMode, QuestionPurpose } from "../../questions/domain/question.schema.js";
 import type { EnrichmentRunQueue, EnrichmentRunStore } from "../interfaces/enrichment-run.interface.js";
 import type { McpActivityCaller } from "./activity-projection.js";
 export type IdentityContext = UserIdentity | null;

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

@@ -1460,6 +1460,7 @@ export interface Database {
         networkIds: string[];
         excludeUserId: string;
         limit: number;
+        minScore?: number;
     }): Promise<Array<{
         premiseId: string;
         userId: string;
@@ -1500,6 +1501,7 @@ export interface Database {
         networkIds: string[];
         excludeUserId: string;
         limitPerSource: number;
+        minScore?: number;
     }): Promise<Array<{
         sourcePremiseId: string;
         premiseId: string;

package/dist/shared/schemas/pending-question.schema.d.ts

@@ -3,7 +3,7 @@
  * in tool results. Omits internal fields (actors, answer, status) that
  * are not needed by the chat agent or MCP client.
  */
-import type { QuestionMode, QuestionPurpose } from "./question.schema.js";
+import type { QuestionMode, QuestionPurpose } from "../../questions/domain/question.schema.js";
 export interface PendingQuestionSummary {
     id: string;
     title: string;

package/dist/signals/application/intent.clarifier.js

@@ -13,7 +13,7 @@ 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 { UnderspecificationTypeSchema } from "../../shared/schemas/question.schema.js";
+import { UnderspecificationTypeSchema } from "../../questions/domain/question.schema.js";
 const logger = protocolLogger("IntentClarifier");
 const clarificationSchema = z.discriminatedUnion("needsClarification", [
     z.object({

package/dist/signals/application/intent.graph.d.ts

@@ -150,7 +150,7 @@ export declare class IntentGraphFactory {
             message?: string;
             networkId?: string;
         } | undefined> | undefined;
-    }, "query" | "__start__" | "inference" | "verification" | "prep" | "reconciler" | "executor", {
+    }, "query" | "__start__" | "prep" | "inference" | "verification" | "reconciler" | "executor", {
         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/signals/application/intent.verifier.d.ts

@@ -9,13 +9,13 @@ declare const responseFormat: z.ZodObject<{
         authority: z.ZodNumber;
         sincerity: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        sincerity: number;
         clarity: number;
         authority: number;
-    }, {
         sincerity: number;
+    }, {
         clarity: number;
         authority: number;
+        sincerity: number;
     }>;
     semantic_entropy: z.ZodNumber;
     referential_anchor: z.ZodNullable<z.ZodString>;
@@ -27,9 +27,9 @@ declare const responseFormat: z.ZodObject<{
     reasoning: string;
     classification: "COMMISSIVE" | "DIRECTIVE" | "ASSERTIVE" | "EXPRESSIVE" | "DECLARATION" | "UNKNOWN";
     felicity_scores: {
-        sincerity: number;
         clarity: number;
         authority: number;
+        sincerity: number;
     };
     semantic_entropy: number;
     referential_anchor: string | null;
@@ -41,9 +41,9 @@ declare const responseFormat: z.ZodObject<{
     reasoning: string;
     classification: "COMMISSIVE" | "DIRECTIVE" | "ASSERTIVE" | "EXPRESSIVE" | "DECLARATION" | "UNKNOWN";
     felicity_scores: {
-        sincerity: number;
         clarity: number;
         authority: number;
+        sincerity: number;
     };
     semantic_entropy: number;
     referential_anchor: string | null;
@@ -67,9 +67,9 @@ export declare class SemanticVerifier {
         reasoning: string;
         classification: "COMMISSIVE" | "DIRECTIVE" | "ASSERTIVE" | "EXPRESSIVE" | "DECLARATION" | "UNKNOWN";
         felicity_scores: {
-            sincerity: number;
             clarity: number;
             authority: number;
+            sincerity: number;
         };
         semantic_entropy: number;
         referential_anchor: string | null;
@@ -100,9 +100,9 @@ export declare class SemanticVerifier {
         reasoning: string;
         classification: "COMMISSIVE" | "DIRECTIVE" | "ASSERTIVE" | "EXPRESSIVE" | "DECLARATION" | "UNKNOWN";
         felicity_scores: {
-            sincerity: number;
             clarity: number;
             authority: number;
+            sincerity: number;
         };
         semantic_entropy: number;
         referential_anchor: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "10.1.3-rc.453.1",
+  "version": "11.0.1-rc.455.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",