@indexnetwork/protocol 14.0.0-rc.468.1 → 14.2.0-rc.470.1

package/dist/opportunity/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * opportunity — the capability's sole cross-capability surface.
+ *
+ * Anything outside this capability imports from here and nowhere else.
+ * Supersedes the capabilities/*.facade.ts + opportunity/public/ pair; the export
+ * list is the union of the facades it replaces, so the contract is unchanged.
+ */
+export { getOrCreateDeliveryCardBatch, } from "./application/delivery-card.cache.js";
+export { OpportunityEvaluator, } from "./application/opportunity.evaluator.js";
+export type { EvaluatorInput, } from "./application/opportunity.evaluator.js";
+export { OpportunityGraphFactory, } from "./application/opportunity.graph.js";
+export type { OpportunityGraphThresholdOverrides, } from "./application/opportunity.graph.js";
+export { isIntroducerDiscoveryEnabled, } from "./application/opportunity.introducer-feature.js";
+export { INTRODUCER_DISCOVERY_SOURCE, MAX_CANDIDATES_PER_CONTACT, MAX_CONTACTS_PER_CYCLE, runIntroducerDiscovery, selectContactsForDiscovery, shouldRunIntroducerDiscovery, } from "./application/opportunity.introducer.js";
+export type { ContactWithIntents, IntroducerDiscoveryDatabase, IntroducerDiscoveryQueue, } from "./application/opportunity.introducer.js";
+export type { StampNewbornOpportunitiesFn, StampNewbornOpportunitiesInput, } from "./application/opportunity.newborn-stamping.js";
+export { opportunityOwnerActionForStatus, } from "./application/opportunity.owner-approval.js";
+export type { OpportunityOwnerAction, OpportunityOwnerApprovalAttestation, OpportunityOwnerApprovalAuthority, OpportunityOwnerApprovalBinding, OpportunityOwnerApprovalChallenge, OpportunityOwnerApprovalDenialReason, OpportunityOwnerApprovalVerdict, OpportunityOwnerInteractionProvenance, OpportunityOwnerInteractionSurface, } from "./application/opportunity.owner-approval.js";
+export { bindOwnerApprovalProvenance, } from "./application/opportunity.owner-provenance.js";
+export { persistOpportunities, } from "./application/opportunity.persist.js";
+export { gatherPresenterContext, OpportunityPresenter, } from "./application/opportunity.presenter.js";
+export type { PresenterDatabase, } from "./application/opportunity.presenter.js";
+export { createOpportunityTools, } from "./application/opportunity.tools.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, mergePoolAdjustment, planPoolAdjustments, } from "./discriminator/discriminator.adjustments.js";
+export type { PoolAdjustment, PoolAdjustmentSignal, } from "./discriminator/discriminator.adjustments.js";
+export { PoolDiscriminatorAssigner, } from "./discriminator/discriminator.assigner.js";
+export type { PoolDiscriminatorAssignedAxis, PoolDiscriminatorAssignmentInput, } from "./discriminator/discriminator.assigner.js";
+export { POOL_DISCRIMINATOR_MAX_CANDIDATES, POOL_DISCRIMINATOR_MAX_PUBLIC_CONTEXT_CHARS, POOL_DISCRIMINATOR_MIN_POOL_SIZE, POOL_QUESTION_MAX_PENDING_PER_INTENT, POOL_QUESTION_MIN_VOI, POOL_RERUN_DEBOUNCE_MS, POOL_VISIT_MINING_DEBOUNCE_MS, poolQuestionsMiningMode, poolQuestionsMode, poolQuestionsPushMode, poolQuestionsRanking, poolQuestionsStampNewborn, poolQuestionsVisitTrigger, } from "./discriminator/discriminator.env.js";
+export { PoolDiscriminatorMiner, } from "./discriminator/discriminator.miner.js";
+export { buildPoolQuestionPushMessage, poolQuestionCycleKey, } from "./discriminator/discriminator.push.js";
+export { BOTH_MATTER_LABEL, selectQuestionDiscriminators, synthesizePoolQuestion, toQuestionDiscriminator, } from "./discriminator/discriminator.question.js";
+export { runPoolDiscriminatorShadow, } from "./discriminator/discriminator.shadow.js";
+export type { DiscriminatorMiningInput, MinedDiscriminator, PoolCandidate, } from "./discriminator/discriminator.types.js";
+export { hasUnsupportedOpportunityClaim, stripUnsupportedOpportunityClaims, stripUnsupportedOpportunityClaims as stripUnsupportedOpportunityClaimsText, } from "../shared/utils/claim-safety.js";
+export { buildCandidateEvidence, } from "./domain/opportunity.evidence.js";
+export { getPrimaryActionLabel, } from "./domain/opportunity.labels.js";
+export { buildApiChatCardPresentationCacheKey, buildDeliveryCardPresentationCacheKey, buildRadarCardPresentationCacheKey, } from "./domain/opportunity.presentation-cache.js";
+export { presentOpportunity, stripUuids, truncateAtBoundary, } from "./domain/opportunity.presentation.js";
+export type { UserInfo, } from "./domain/opportunity.presentation.js";
+export { DEFAULT_FALLBACK_HEADLINE, safeFallbackSummary, } from "./domain/opportunity.safe-presentation.js";
+export { canUserSeeOpportunity, classifyOpportunity, isActionableForViewer, RADAR_SOFT_TARGETS, selectByComposition, validateOpportunityActors, } from "./domain/opportunity.utils.js";
+export { NEGOTIATION_EVIDENCE_MAX_OPPORTUNITIES, negotiationEvidenceQuestionsMode, } from "./negotiation-evidence/negotiation-evidence.env.js";
+export { NegotiationEvidenceMiner, } from "./negotiation-evidence/negotiation-evidence.miner.js";
+export { runNegotiationEvidenceShadow, } from "./negotiation-evidence/negotiation-evidence.shadow.js";
+export type { RawEvidenceOutcome, RawEvidenceOwnerAnswer, RawEvidenceSegment, RawEvidenceTurn, } from "./negotiation-evidence/negotiation-evidence.types.js";
+export { isOutcomeQuestionsActivated, OUTCOME_MAX_CANDIDATES, OUTCOME_MAX_PUBLIC_CONTEXT_CHARS, OUTCOME_MIN_INDEPENDENT_EXAMPLES, } from "./outcome/outcome.env.js";
+export { runOutcomeShadow, } from "./outcome/outcome.shadow.js";
+export type { OutcomeExample, OutcomeLabel, OutcomeShadowResult, } from "./outcome/outcome.types.js";
+export type { OpportunityToolDeps, } from "./ports/index.js";
+export { RadarGraphFactory, } from "./radar/radar.graph.js";
+export { computeRadarHealth, } from "./radar/radar.health.js";
+export type { RadarHealthInput, } from "./radar/radar.health.js";

package/dist/opportunity/index.js

@@ -0,0 +1,39 @@
+/**
+ * opportunity — the capability's sole cross-capability surface.
+ *
+ * Anything outside this capability imports from here and nowhere else.
+ * Supersedes the capabilities/*.facade.ts + opportunity/public/ pair; the export
+ * list is the union of the facades it replaces, so the contract is unchanged.
+ */
+export { getOrCreateDeliveryCardBatch, } from "./application/delivery-card.cache.js";
+export { OpportunityEvaluator, } from "./application/opportunity.evaluator.js";
+export { OpportunityGraphFactory, } from "./application/opportunity.graph.js";
+export { isIntroducerDiscoveryEnabled, } from "./application/opportunity.introducer-feature.js";
+export { INTRODUCER_DISCOVERY_SOURCE, MAX_CANDIDATES_PER_CONTACT, MAX_CONTACTS_PER_CYCLE, runIntroducerDiscovery, selectContactsForDiscovery, shouldRunIntroducerDiscovery, } from "./application/opportunity.introducer.js";
+export { opportunityOwnerActionForStatus, } from "./application/opportunity.owner-approval.js";
+export { bindOwnerApprovalProvenance, } from "./application/opportunity.owner-provenance.js";
+export { persistOpportunities, } from "./application/opportunity.persist.js";
+export { gatherPresenterContext, OpportunityPresenter, } from "./application/opportunity.presenter.js";
+export { createOpportunityTools, } from "./application/opportunity.tools.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, mergePoolAdjustment, planPoolAdjustments, } from "./discriminator/discriminator.adjustments.js";
+export { PoolDiscriminatorAssigner, } from "./discriminator/discriminator.assigner.js";
+export { POOL_DISCRIMINATOR_MAX_CANDIDATES, POOL_DISCRIMINATOR_MAX_PUBLIC_CONTEXT_CHARS, POOL_DISCRIMINATOR_MIN_POOL_SIZE, POOL_QUESTION_MAX_PENDING_PER_INTENT, POOL_QUESTION_MIN_VOI, POOL_RERUN_DEBOUNCE_MS, POOL_VISIT_MINING_DEBOUNCE_MS, poolQuestionsMiningMode, poolQuestionsMode, poolQuestionsPushMode, poolQuestionsRanking, poolQuestionsStampNewborn, poolQuestionsVisitTrigger, } from "./discriminator/discriminator.env.js";
+export { PoolDiscriminatorMiner, } from "./discriminator/discriminator.miner.js";
+export { buildPoolQuestionPushMessage, poolQuestionCycleKey, } from "./discriminator/discriminator.push.js";
+export { BOTH_MATTER_LABEL, selectQuestionDiscriminators, synthesizePoolQuestion, toQuestionDiscriminator, } from "./discriminator/discriminator.question.js";
+export { runPoolDiscriminatorShadow, } from "./discriminator/discriminator.shadow.js";
+export { hasUnsupportedOpportunityClaim, stripUnsupportedOpportunityClaims, stripUnsupportedOpportunityClaims as stripUnsupportedOpportunityClaimsText, } from "../shared/utils/claim-safety.js";
+export { buildCandidateEvidence, } from "./domain/opportunity.evidence.js";
+export { getPrimaryActionLabel, } from "./domain/opportunity.labels.js";
+export { buildApiChatCardPresentationCacheKey, buildDeliveryCardPresentationCacheKey, buildRadarCardPresentationCacheKey, } from "./domain/opportunity.presentation-cache.js";
+export { presentOpportunity, stripUuids, truncateAtBoundary, } from "./domain/opportunity.presentation.js";
+export { DEFAULT_FALLBACK_HEADLINE, safeFallbackSummary, } from "./domain/opportunity.safe-presentation.js";
+export { canUserSeeOpportunity, classifyOpportunity, isActionableForViewer, RADAR_SOFT_TARGETS, selectByComposition, validateOpportunityActors, } from "./domain/opportunity.utils.js";
+export { NEGOTIATION_EVIDENCE_MAX_OPPORTUNITIES, negotiationEvidenceQuestionsMode, } from "./negotiation-evidence/negotiation-evidence.env.js";
+export { NegotiationEvidenceMiner, } from "./negotiation-evidence/negotiation-evidence.miner.js";
+export { runNegotiationEvidenceShadow, } from "./negotiation-evidence/negotiation-evidence.shadow.js";
+export { isOutcomeQuestionsActivated, OUTCOME_MAX_CANDIDATES, OUTCOME_MAX_PUBLIC_CONTEXT_CHARS, OUTCOME_MIN_INDEPENDENT_EXAMPLES, } from "./outcome/outcome.env.js";
+export { runOutcomeShadow, } from "./outcome/outcome.shadow.js";
+export { RadarGraphFactory, } from "./radar/radar.graph.js";
+export { computeRadarHealth, } from "./radar/radar.health.js";

package/dist/opportunity/radar/radar.graph.d.ts

@@ -13,7 +13,7 @@
 import type { RadarGraphDatabase, OpportunityStatus } from '../../shared/interfaces/database.interface.js';
 import type { OpportunityCache } from '../../shared/interfaces/cache.interface.js';
 import { type RadarCardItem, type RadarResponseItem } from './radar.state.js';
-import type { DebugMetaAgent } from '../../capabilities/participant-agents.debug.facade.js';
+import type { DebugMetaAgent } from '../../participant-agents/index.js';
 /** Database must satisfy both RadarGraphDatabase and presenter context (getProfile, getActiveIntents, getNetwork, getUser). */
 type RadarGraphDb = RadarGraphDatabase;
 export type RadarGraphInvokeInput = {

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

@@ -1,5 +1,5 @@
 import type { Opportunity, OpportunityStatus } from '../../shared/interfaces/database.interface.js';
-import type { DebugMetaAgent } from '../../capabilities/participant-agents.debug.facade.js';
+import type { DebugMetaAgent } from '../../participant-agents/index.js';
 /**
  * Radar card item: one opportunity with full presenter-driven display contract.
  */

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

@@ -0,0 +1,22 @@
+/**
+ * participant-agents — the capability's sole cross-capability surface.
+ *
+ * Anything outside this capability imports from here and nowhere else.
+ * Supersedes the capabilities/*.facade.ts + participant-agents/public/ pair; the export
+ * list is the union of the facades it replaces, so the contract is unchanged.
+ */
+export type { DebugMetaAgent, } from "../chat/chat-streaming.types.js";
+export { ChatGraphFactory, } from "../chat/chat.graph.js";
+export { ChatInterruptClassifier, } from "../chat/chat.interrupt.classifier.js";
+export type { ChatPersonaConfig, } from "../chat/chat.persona.js";
+export { SuggestionGenerator, } from "../chat/chat.suggester.js";
+export { ChatSummarizer, } from "../chat/chat.summarizer.js";
+export { ChatTitleGenerator, } from "../chat/chat.title.generator.js";
+export { createChatTools, } from "../chat/chat.tools.js";
+export { createNegotiatorPersona, NEGOTIATOR_PERSONA_ID, } from "../chat/negotiator.persona.js";
+export { createOnboardingTools, filterOnboardingTools, narrowOnboardingTools, ONBOARDING_PERSONA, ONBOARDING_PERSONA_ID, ONBOARDING_PROFILE_KICKOFF, ONBOARDING_TOOL_NAMES, } from "../chat/onboarding.persona.js";
+export { createReporterTools, filterReporterTools, narrowReporterTools, REPORTER_BRIEFING_KICKOFF, REPORTER_PERSONA, REPORTER_PERSONA_ID, REPORTER_TOOL_NAMES, } from "../chat/reporter.persona.js";
+export { createSignalTools, filterSignalTools, narrowSignalTools, SIGNAL_NEW_SIGNAL_KICKOFF, SIGNAL_PERSONA, SIGNAL_PERSONA_ID, SIGNAL_TOOL_NAMES, } from "../chat/signal.persona.js";
+export { createAgentTools, } from "./application/index.js";
+export { SYSTEM_AGENT_IDS, } from "./domain/index.js";
+export type { AgentToolDeps, } from "./ports/index.js";

package/dist/participant-agents/index.js

@@ -0,0 +1,12 @@
+export { ChatGraphFactory, } from "../chat/chat.graph.js";
+export { ChatInterruptClassifier, } from "../chat/chat.interrupt.classifier.js";
+export { SuggestionGenerator, } from "../chat/chat.suggester.js";
+export { ChatSummarizer, } from "../chat/chat.summarizer.js";
+export { ChatTitleGenerator, } from "../chat/chat.title.generator.js";
+export { createChatTools, } from "../chat/chat.tools.js";
+export { createNegotiatorPersona, NEGOTIATOR_PERSONA_ID, } from "../chat/negotiator.persona.js";
+export { createOnboardingTools, filterOnboardingTools, narrowOnboardingTools, ONBOARDING_PERSONA, ONBOARDING_PERSONA_ID, ONBOARDING_PROFILE_KICKOFF, ONBOARDING_TOOL_NAMES, } from "../chat/onboarding.persona.js";
+export { createReporterTools, filterReporterTools, narrowReporterTools, REPORTER_BRIEFING_KICKOFF, REPORTER_PERSONA, REPORTER_PERSONA_ID, REPORTER_TOOL_NAMES, } from "../chat/reporter.persona.js";
+export { createSignalTools, filterSignalTools, narrowSignalTools, SIGNAL_NEW_SIGNAL_KICKOFF, SIGNAL_PERSONA, SIGNAL_PERSONA_ID, SIGNAL_TOOL_NAMES, } from "../chat/signal.persona.js";
+export { createAgentTools, } from "./application/index.js";
+export { SYSTEM_AGENT_IDS, } from "./domain/index.js";

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

@@ -1,16 +1,13 @@
 /**
- * participant-context — domain-first module root.
+ * participant-context — the capability's sole cross-capability surface.
  *
- * Re-exports the curated public surface.  Other modules inside the
- * participant-context capability import directly from
- * participant-context/domain, participant-context/application, or
- * participant-context/ports; this barrel is for cross-capability consumers
- * that must go through the participant-context public surface.
+ * Enrichment, premises, generated participant context, and HyDE representations
+ * are one capability; only orchestration entry points and the read-model
+ * generator cross its edge.
  *
- * IND-545: canonical home for premise/context/enrichment/HyDE behaviour that
- * was previously spread across premise/, context/, enrichment/, and
- * shared/hyde/.  Legacy paths in capabilities/participant-context.facade and
- * direct shared/hyde imports from root index.ts remain as compatibility
- * re-exports pointing here.
+ * Anything outside this capability imports from here and nowhere else.
+ * 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 * from "./public/index.js";
+export { createEnrichmentTools, createPremiseTools, EnrichmentGraphFactory, PremiseGraphFactory, UserContextGenerator, HydeGraphFactory, HydeGenerator, LensInferrer, } from "./application/index.js";
+export type { EnrichmentToolDeps, PremiseToolDeps, } from "./ports/participant-context.tools.port.js";

package/dist/participant-context/index.js

@@ -1,16 +1,14 @@
 /**
- * participant-context — domain-first module root.
+ * participant-context — the capability's sole cross-capability surface.
  *
- * Re-exports the curated public surface.  Other modules inside the
- * participant-context capability import directly from
- * participant-context/domain, participant-context/application, or
- * participant-context/ports; this barrel is for cross-capability consumers
- * that must go through the participant-context public surface.
+ * Enrichment, premises, generated participant context, and HyDE representations
+ * are one capability; only orchestration entry points and the read-model
+ * generator cross its edge.
  *
- * IND-545: canonical home for premise/context/enrichment/HyDE behaviour that
- * was previously spread across premise/, context/, enrichment/, and
- * shared/hyde/.  Legacy paths in capabilities/participant-context.facade and
- * direct shared/hyde imports from root index.ts remain as compatibility
- * re-exports pointing here.
+ * Anything outside this capability imports from here and nowhere else.
+ * 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 * from "./public/index.js";
+export { createEnrichmentTools, createPremiseTools, EnrichmentGraphFactory, PremiseGraphFactory, UserContextGenerator, 
+// HyDE — participant-context technology binding
+HydeGraphFactory, HydeGenerator, LensInferrer, } from "./application/index.js";

package/dist/{capabilities → participant-context/ports}/participant-context.tools.port.d.ts

@@ -1,4 +1,4 @@
-import type { ToolRegistryCompositionDeps } from "../shared/agent/tool.helpers.js";
+import type { ToolRegistryCompositionDeps } from "../../shared/agent/tool.helpers.js";
 /** Host capabilities consumed by enrichment and premise-derived identity tools. */
 export type EnrichmentToolDeps = Pick<ToolRegistryCompositionDeps, "userDb" | "systemDb" | "enricher" | "grantDefaultSystemPermissions" | "reportToolError" | "getUserContextText" | "enrichmentRuns" | "enrichmentRunQueue"> & {
     graphs: Pick<ToolRegistryCompositionDeps["graphs"], "profile">;

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

@@ -2,7 +2,7 @@ import type { PremiseAnalyzerOutput } from "./premise.analyzer.js";
 import { PremiseIndexer } from "./premise.indexer.js";
 import type { PremiseGraphDatabase, PremiseAnalysis } from "../shared/interfaces/database.interface.js";
 import type { Embedder } from "../shared/interfaces/embedder.interface.js";
-import type { DebugMetaAgent } from "../capabilities/participant-agents.debug.facade.js";
+import type { DebugMetaAgent } from "../participant-agents/index.js";
 /**
  * Graph factory for premise lifecycle: create, update, and query modes.
  */

package/dist/premise/premise.state.d.ts

@@ -1,5 +1,5 @@
 import type { PremiseAnalysis, PremiseRecord } from "../shared/interfaces/database.interface.js";
-import type { DebugMetaAgent } from '../capabilities/participant-agents.debug.facade.js';
+import type { DebugMetaAgent } from '../participant-agents/index.js';
 import type { ToolScopeType } from '../shared/agent/tool.scope.js';
 export declare const PremiseGraphState: import("@langchain/langgraph").AnnotationRoot<{
     userId: {

package/dist/premise/premise.tools.d.ts

@@ -1,3 +1,3 @@
 import type { DefineTool } from "../shared/agent/tool.helpers.js";
-import type { PremiseToolDeps } from "../capabilities/participant-context.tools.port.js";
+import type { PremiseToolDeps } from "../participant-context/ports/participant-context.tools.port.js";
 export declare function createPremiseTools(defineTool: DefineTool, deps: PremiseToolDeps): any[];

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

@@ -32,7 +32,7 @@ export { isValidQuestionerInputContract, } from "./question.input.js";
 export type { QuestionerInput, QuestionerContext, QuestionerEnqueuePayload, QuestionerEnqueueFn, IntentContext, RecoveryIntentContext, NegotiationContext, PostStallNegotiationContext, UptakeNegotiationContext, NegotiationInflightContext, ChatContext, PoolDiscoveryContext, PostStallQuestionerInput, InflightQuestionerInput, UptakeQuestionerInput, RecoveryQuestionerInput, } from "./question.input.js";
 export { QuestionerAgent } from "./question.agent.js";
 export type { QuestionerAgentConfig } from "./question.agent.js";
-export { isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, chatQuestionWaitTimeoutMs, CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT, UPTAKE_AUTHORITY_THRESHOLD_DEFAULT, } from "./question.env.js";
+export { isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, chatQuestionWaitTimeoutMs, intentQuestionDailyCap, CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT, UPTAKE_AUTHORITY_THRESHOLD_DEFAULT, INTENT_QUESTION_DAILY_CAP_DEFAULT, INTENT_QUESTION_DAILY_WINDOW_HOURS, } from "./question.env.js";
 export { getPreset } from "./question.presets.js";
 export type { QuestionerPreset } from "./question.presets.js";
 export { createQuestionerTools } from "./question.tools.js";

package/dist/questions/application/index.js

@@ -33,7 +33,7 @@ export { isValidQuestionerInputContract, } from "./question.input.js";
 // ── Agent ─────────────────────────────────────────────────────────────────────
 export { QuestionerAgent } from "./question.agent.js";
 // ── Env ───────────────────────────────────────────────────────────────────────
-export { isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, chatQuestionWaitTimeoutMs, CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT, UPTAKE_AUTHORITY_THRESHOLD_DEFAULT, } from "./question.env.js";
+export { isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, chatQuestionWaitTimeoutMs, intentQuestionDailyCap, CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT, UPTAKE_AUTHORITY_THRESHOLD_DEFAULT, INTENT_QUESTION_DAILY_CAP_DEFAULT, INTENT_QUESTION_DAILY_WINDOW_HOURS, } from "./question.env.js";
 // ── Presets ───────────────────────────────────────────────────────────────────
 export { getPreset } from "./question.presets.js";
 // ── Foreground adapter tools ──────────────────────────────────────────────────

package/dist/questions/application/question.env.d.ts

@@ -11,6 +11,9 @@
  *                                       authority threshold (0-100, default 70).
  *   QUESTIONER_CHAT_WAIT_TIMEOUT_MS     how long the blocking ask_user_question chat
  *                                       tool waits for an inline answer (default 4 min).
+ *   QUESTIONER_INTENT_DAILY_CAP         refinement questions one intent may generate
+ *                                       per rolling 24h, recovery + pool combined
+ *                                       (default 2; 0 disables refinement).
  *
  * All reads go through this module — do not read these variables via
  * `process.env` elsewhere. Values are read on every call (no caching) so tests
@@ -21,6 +24,25 @@
  */
 export declare const CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT = 240000;
 export declare const UPTAKE_AUTHORITY_THRESHOLD_DEFAULT = 70;
+/**
+ * Refinement questions a single intent may generate per rolling window.
+ *
+ * Recovery and pool mining both re-arm when the intent text changes, and
+ * answering a refinement question is itself what changes it — so each answer
+ * buys another question and the loop ends only when the user stops replying.
+ * Measured on a dev account: 27 questions against three intents in 9.5 hours,
+ * one discriminator asked three times, while the best-scoring match had already
+ * been found after the first question.
+ */
+export declare const INTENT_QUESTION_DAILY_CAP_DEFAULT = 2;
+/**
+ * Width of the budget window, in hours.
+ *
+ * Rolling rather than per-UTC-day deliberately: the observed bursts straddled
+ * midnight UTC (20:22-21:18, then 05:48-05:55), and a calendar-day budget would
+ * have granted the second burst a full fresh allowance.
+ */
+export declare const INTENT_QUESTION_DAILY_WINDOW_HOURS = 24;
 /** Master switch: is any background question generation enabled? */
 export declare function isQuestionerEnabled(): boolean;
 /** Advisory uptake interlock. Flag-off by default and subordinate to the master switch. */
@@ -29,3 +51,10 @@ export declare function isUptakeGuardEnabled(): boolean;
 export declare function uptakeAuthorityThreshold(): number;
 /** Wait budget for the blocking ask_user_question chat tool. */
 export declare function chatQuestionWaitTimeoutMs(): number;
+/**
+ * Per-intent refinement budget over {@link INTENT_QUESTION_DAILY_WINDOW_HOURS}.
+ *
+ * Zero is a meaningful setting — it disables background refinement entirely
+ * without touching the master switch — so this does not reuse `positiveIntEnv`.
+ */
+export declare function intentQuestionDailyCap(): number;

package/dist/questions/application/question.env.js

@@ -11,6 +11,9 @@
  *                                       authority threshold (0-100, default 70).
  *   QUESTIONER_CHAT_WAIT_TIMEOUT_MS     how long the blocking ask_user_question chat
  *                                       tool waits for an inline answer (default 4 min).
+ *   QUESTIONER_INTENT_DAILY_CAP         refinement questions one intent may generate
+ *                                       per rolling 24h, recovery + pool combined
+ *                                       (default 2; 0 disables refinement).
  *
  * All reads go through this module — do not read these variables via
  * `process.env` elsewhere. Values are read on every call (no caching) so tests
@@ -21,6 +24,25 @@
  */
 export const CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT = 240000;
 export const UPTAKE_AUTHORITY_THRESHOLD_DEFAULT = 70;
+/**
+ * Refinement questions a single intent may generate per rolling window.
+ *
+ * Recovery and pool mining both re-arm when the intent text changes, and
+ * answering a refinement question is itself what changes it — so each answer
+ * buys another question and the loop ends only when the user stops replying.
+ * Measured on a dev account: 27 questions against three intents in 9.5 hours,
+ * one discriminator asked three times, while the best-scoring match had already
+ * been found after the first question.
+ */
+export const INTENT_QUESTION_DAILY_CAP_DEFAULT = 2;
+/**
+ * Width of the budget window, in hours.
+ *
+ * Rolling rather than per-UTC-day deliberately: the observed bursts straddled
+ * midnight UTC (20:22-21:18, then 05:48-05:55), and a calendar-day budget would
+ * have granted the second burst a full fresh allowance.
+ */
+export const INTENT_QUESTION_DAILY_WINDOW_HOURS = 24;
 /**
  * Parse a positive integer env var, clamped to the safe-integer range so a
  * malformed env value cannot crash `AbortSignal.timeout` (which throws on
@@ -57,3 +79,17 @@ export function uptakeAuthorityThreshold() {
 export function chatQuestionWaitTimeoutMs() {
     return positiveIntEnv("QUESTIONER_CHAT_WAIT_TIMEOUT_MS", CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT);
 }
+/**
+ * Per-intent refinement budget over {@link INTENT_QUESTION_DAILY_WINDOW_HOURS}.
+ *
+ * Zero is a meaningful setting — it disables background refinement entirely
+ * without touching the master switch — so this does not reuse `positiveIntEnv`.
+ */
+export function intentQuestionDailyCap() {
+    const raw = process.env.QUESTIONER_INTENT_DAILY_CAP;
+    if (!raw?.trim())
+        return INTENT_QUESTION_DAILY_CAP_DEFAULT;
+    if (!/^\d+$/.test(raw.trim()))
+        return INTENT_QUESTION_DAILY_CAP_DEFAULT;
+    return Number.parseInt(raw, 10);
+}

package/dist/questions/application/question.input.d.ts

@@ -19,7 +19,7 @@
  */
 import type { ToolScopeType } from "../../shared/agent/tool.scope.js";
 import type { NegotiationQuestionCandidate, QuestionMode, QuestionPoolDiscriminator } from "../domain/question.schema.js";
-import type { NegotiationConsultationReason } from "../../capabilities/negotiation.questions.facade.js";
+import type { NegotiationConsultationReason } from "../../negotiation/index.js";
 /** Intent context — data needed to generate questions about an intent. */
 export interface IntentContext {
     intentId: string;

package/dist/questions/application/question.input.js

@@ -1,4 +1,4 @@
-import { NEGOTIATION_QUESTION_GENERIC_COUNTERPARTY, NEGOTIATION_QUESTION_GENERIC_NETWORK, NEGOTIATION_QUESTION_GENERIC_UPTAKE_ACTIVITY } from "../../capabilities/negotiation.questions.facade.js";
+import { NEGOTIATION_QUESTION_GENERIC_COUNTERPARTY, NEGOTIATION_QUESTION_GENERIC_NETWORK, NEGOTIATION_QUESTION_GENERIC_UPTAKE_ACTIVITY } from "../../negotiation/index.js";
 /** Runtime mirror of the mode/purpose/context discriminant used at queue boundaries. */
 export function isValidQuestionerInputContract(input) {
     if (input.purpose === 'recovery') {

package/dist/questions/application/question.presets.js

@@ -1,5 +1,5 @@
 import { QUD_UNDERSPECIFICATION_RULES } from "./question.qud.js";
-import { consultationPromptFor } from "../../capabilities/negotiation.questions.facade.js";
+import { consultationPromptFor } from "../../negotiation/index.js";
 /**
  * Shared rule block appended to every questioner system prompt. Enforces that
  * the generated `prompt` resolves on its own — no demonstratives/anaphora that

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

@@ -8,6 +8,8 @@
  * IND-547: canonical question schema in the questions domain layer.
  */
 import { z } from "zod";
+import { UnderspecificationTypeSchema, type UnderspecificationType } from "../../shared/schemas/underspecification.schema.js";
+export { UnderspecificationTypeSchema };
 export declare const QuestionOptionSchema: z.ZodObject<{
     /** Display text. Suffix " (Recommended)" on the safest path; list it first. */
     label: z.ZodString;
@@ -75,8 +77,6 @@ export declare const QuestionSchema: z.ZodObject<{
     multiSelect: boolean;
     evidence?: string | null | undefined;
 }>;
-/** Canonical QUD repair categories for underspecified intents/questions. */
-export declare const UnderspecificationTypeSchema: z.ZodEnum<["missing_constituent", "missing_constraint", "open_alternative_set"]>;
 export declare const QuestionStrategySchema: z.ZodEnum<["refine_intent", "surface_missing_detail", "open_adjacent_thread", "reflective_summary", "surface_emergent_knowledge"]>;
 export declare const QuestionWithStrategySchema: z.ZodObject<{
     /** ≤12 chars. Noun of the decision domain — e.g. "Stage", "Timing", "Role". */
@@ -234,7 +234,7 @@ export declare const QuestionGeneratorResponseSchema: z.ZodObject<{
 }>;
 export type QuestionOption = z.infer<typeof QuestionOptionSchema>;
 export type Question = z.infer<typeof QuestionSchema>;
-export type UnderspecificationType = z.infer<typeof UnderspecificationTypeSchema>;
+export type { UnderspecificationType };
 export type QuestionStrategy = z.infer<typeof QuestionStrategySchema>;
 export type QuestionWithStrategy = z.infer<typeof QuestionWithStrategySchema>;
 export type QuestionGeneratorResponse = z.infer<typeof QuestionGeneratorResponseSchema>;

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

@@ -8,6 +8,8 @@
  * IND-547: canonical question schema in the questions domain layer.
  */
 import { z } from "zod";
+import { UnderspecificationTypeSchema } from "../../shared/schemas/underspecification.schema.js";
+export { UnderspecificationTypeSchema };
 export const QuestionOptionSchema = z.object({
     /** Display text. Suffix " (Recommended)" on the safest path; list it first. */
     label: z.string().min(1).max(120),
@@ -40,12 +42,6 @@ export const QuestionSchema = z.object({
      */
     evidence: z.string().min(1).max(160).nullable().optional().transform((value) => value ?? undefined),
 });
-/** Canonical QUD repair categories for underspecified intents/questions. */
-export const UnderspecificationTypeSchema = z.enum([
-    "missing_constituent",
-    "missing_constraint",
-    "open_alternative_set",
-]);
 export const QuestionStrategySchema = z.enum([
     "refine_intent",
     "surface_missing_detail",

package/dist/questions/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * questions — the capability's sole cross-capability surface.
+ *
+ * Anything outside this capability imports from here and nowhere else.
+ * Supersedes the capabilities/*.facade.ts + questions/public/ pair; the export
+ * list is the union of the facades it replaces, so the contract is unchanged.
+ */
+export type { QuestionerEnqueueFn, } from "./application/question.input.js";
+export { createAskUserQuestionTools, createQuestionerTools, INTENT_QUESTION_DAILY_CAP_DEFAULT, INTENT_QUESTION_DAILY_WINDOW_HOURS, intentQuestionDailyCap, isQuestionerEnabled, isUptakeGuardEnabled, isValidQuestionerInputContract, QuestionerAgent, uptakeAuthorityThreshold, } from "./application/index.js";
+export type { InflightQuestionerInput, PoolDiscoveryContext, PostStallQuestionerInput, QuestionerEnqueuePayload, QuestionerInput, RecoveryQuestionerInput, UptakeQuestionerInput, } from "./application/index.js";
+export type { AskUserQuestionToolDeps, ChatQuestionsHost, PersistableQuestion, PersistedQuestion, QuestionerDatabase, QuestionerToolDeps, QuestionFilters, } from "./ports/index.js";
+export { NegotiationQuestionCandidateSchema, NegotiationQuestionProvenanceSchema, UnderspecificationTypeSchema, } from "./domain/index.js";
+export type { NegotiationQuestionCandidate, QuestionOption, NegotiationQuestionProvenance, NegotiationQuestionPurpose, Question, QuestionGenerationResult, QuestionPoolDiscriminator, QuestionPoolPush, QuestionPoolPushRequestReason, QuestionPoolPushRequestStatus, QuestionPoolSnapshot, QuestionPurpose, QuestionRecoverySnapshot, QuestionStrategy, QuestionVoidedReason, UnderspecificationType, } from "./domain/index.js";

package/dist/questions/index.js

@@ -0,0 +1,2 @@
+export { createAskUserQuestionTools, createQuestionerTools, INTENT_QUESTION_DAILY_CAP_DEFAULT, INTENT_QUESTION_DAILY_WINDOW_HOURS, intentQuestionDailyCap, isQuestionerEnabled, isUptakeGuardEnabled, isValidQuestionerInputContract, QuestionerAgent, uptakeAuthorityThreshold, } from "./application/index.js";
+export { NegotiationQuestionCandidateSchema, NegotiationQuestionProvenanceSchema, UnderspecificationTypeSchema, } from "./domain/index.js";

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

@@ -1,13 +1,13 @@
 import { tool } from "@langchain/core/tools";
 import { IntentGraphFactory } from "../../signals/application/intent.graph.js";
 import { EnrichmentGraphFactory } from "../../enrichment/enrichment.graph.js";
-import { OpportunityGraphFactory } from "../../capabilities/opportunities.facade.js";
+import { OpportunityGraphFactory } from "../../opportunity/index.js";
 import { HydeGraphFactory } from "../hyde/hyde.graph.js";
 import { HydeGenerator } from "../hyde/hyde.generator.js";
 import { LensInferrer } from "../hyde/lens.inferrer.js";
-import { NetworkGraphFactory, NetworkMembershipGraphFactory, IntentNetworkGraphFactory } from "../../capabilities/communities.facade.js";
+import { NetworkGraphFactory, NetworkMembershipGraphFactory, IntentNetworkGraphFactory } from "../../communities/index.js";
 import { IntentIndexer } from "../../signals/application/intent.indexer.js";
-import { NegotiationGraphFactory } from "../../capabilities/negotiation.facade.js";
+import { NegotiationGraphFactory } from "../../negotiation/index.js";
 import { PremiseGraphFactory } from "../../premise/premise.graph.js";
 import { protocolLogger } from "../observability/protocol.logger.js";
 import { resolveChatContext, error, redactSensitiveFields } from "./tool.helpers.js";
@@ -15,15 +15,18 @@ import { deriveAllowedNetworkIds, focusedIntentId, scopeFromNetworkId } from "./
 import { invokeToolRuntime, toolRuntimeErrorToResult } from "./tool.runtime.js";
 import { createEnrichmentTools } from "../../enrichment/enrichment.tools.js";
 import { createIntentTools } from "../../signals/application/intent.tools.js";
-import { createNetworkTools } from "../../capabilities/communities.facade.js";
-import { createOpportunityTools } from "../../capabilities/opportunities.facade.js";
+import { createNetworkTools } from "../../communities/index.js";
+import { createOpportunityTools } from "../../opportunity/index.js";
 import { createUtilityTools } from "./utility.tools.js";
-import { createIntegrationTools } from "../../capabilities/integrations.facade.js";
-import { createContactTools } from "../../capabilities/contacts.facade.js";
-import { createAgentTools } from "../../capabilities/participant-agents.tools.facade.js";
-import { createNegotiationTools } from "../../capabilities/negotiation.facade.js";
+import { createIntegrationTools } from "../../integrations/index.js";
+import { createContactTools } from "../../contacts/index.js";
+// The composition root reaches the leaf directly (it is exempt from the barrel
+// rule by design): importing participant-agents/index.js here would pull in the
+// chat personas, which import this module back -- a runtime cycle.
+import { createAgentTools } from "../../participant-agents/application/agent.tools.js";
+import { createNegotiationTools } from "../../negotiation/index.js";
 import { createPremiseTools } from "../../premise/premise.tools.js";
-import { createQuestionerTools, createAskUserQuestionTools } from "../../capabilities/questions.facade.js";
+import { createQuestionerTools, createAskUserQuestionTools } from "../../questions/index.js";
 import { bindOwnerApprovalProvenance } from "../../opportunity/application/opportunity.owner-provenance.js";
 const logger = protocolLogger("ChatTools");
 // ═══════════════════════════════════════════════════════════════════════════════

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

@@ -1,16 +1,16 @@
 import { error, redactSensitiveFields } from './tool.helpers.js';
 import { createEnrichmentTools } from '../../enrichment/enrichment.tools.js';
 import { createIntentTools } from '../../signals/application/intent.tools.js';
-import { createNetworkTools } from '../../capabilities/communities.facade.js';
-import { createOpportunityTools } from '../../capabilities/opportunities.facade.js';
+import { createNetworkTools } from '../../communities/index.js';
+import { createOpportunityTools } from '../../opportunity/index.js';
 import { createUtilityTools } from './utility.tools.js';
-import { createIntegrationTools } from '../../capabilities/integrations.facade.js';
-import { createContactTools } from '../../capabilities/contacts.facade.js';
-import { createAgentTools } from '../../capabilities/participant-agents.tools.facade.js';
-import { createNegotiationTools } from '../../capabilities/negotiation.facade.js';
+import { createIntegrationTools } from '../../integrations/index.js';
+import { createContactTools } from '../../contacts/index.js';
+import { createAgentTools } from '../../participant-agents/index.js';
+import { createNegotiationTools } from '../../negotiation/index.js';
 import { createChatTools } from '../../chat/chat.tools.js';
 import { createPremiseTools } from '../../premise/premise.tools.js';
-import { createQuestionerTools } from '../../capabilities/questions.facade.js';
+import { createQuestionerTools } from '../../questions/index.js';
 import { protocolLogger } from '../observability/protocol.logger.js';
 import { requestContext } from '../observability/request-context.js';
 const logger = protocolLogger('ToolRegistry');

package/dist/shared/schemas/mcp-auth.schema.d.ts

@@ -53,32 +53,32 @@ export declare const McpResolvedIdentitySchema: z.ZodEffects<z.ZodObject<{
     networkScopeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "strict", z.ZodTypeAny, {
     userId: string;
-    agentId?: string | undefined;
     networkScopeId?: string | null | undefined;
+    agentId?: string | undefined;
     enrollmentCapable?: boolean | undefined;
     isDeliveryAgent?: boolean | undefined;
     isSessionAuth?: boolean | undefined;
     isHermesAgent?: boolean | undefined;
 }, {
     userId: string;
-    agentId?: string | undefined;
     networkScopeId?: string | null | undefined;
+    agentId?: string | undefined;
     enrollmentCapable?: boolean | undefined;
     isDeliveryAgent?: boolean | undefined;
     isSessionAuth?: boolean | undefined;
     isHermesAgent?: boolean | undefined;
 }>, {
     userId: string;
-    agentId?: string | undefined;
     networkScopeId?: string | null | undefined;
+    agentId?: string | undefined;
     enrollmentCapable?: boolean | undefined;
     isDeliveryAgent?: boolean | undefined;
     isSessionAuth?: boolean | undefined;
     isHermesAgent?: boolean | undefined;
 }, {
     userId: string;
-    agentId?: string | undefined;
     networkScopeId?: string | null | undefined;
+    agentId?: string | undefined;
     enrollmentCapable?: boolean | undefined;
     isDeliveryAgent?: boolean | undefined;
     isSessionAuth?: boolean | undefined;

package/dist/shared/schemas/underspecification.schema.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+/**
+ * Canonical QUD repair categories for underspecified intents/questions.
+ *
+ * Shared between signals (the intent clarifier decides whether an utterance is
+ * underspecified) and questions (which records the category on the question it
+ * raises). It lives here rather than inside either capability because both need
+ * it: filing it under `questions/domain` meant the signals clarifier had to
+ * import the whole questions capability — LLM agents and tools included — to
+ * reach a three-value enum.
+ */
+export declare const UnderspecificationTypeSchema: z.ZodEnum<["missing_constituent", "missing_constraint", "open_alternative_set"]>;
+export type UnderspecificationType = z.infer<typeof UnderspecificationTypeSchema>;

package/dist/shared/schemas/underspecification.schema.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+/**
+ * Canonical QUD repair categories for underspecified intents/questions.
+ *
+ * Shared between signals (the intent clarifier decides whether an utterance is
+ * underspecified) and questions (which records the category on the question it
+ * raises). It lives here rather than inside either capability because both need
+ * it: filing it under `questions/domain` meant the signals clarifier had to
+ * import the whole questions capability — LLM agents and tools included — to
+ * reach a three-value enum.
+ */
+export const UnderspecificationTypeSchema = z.enum([
+    "missing_constituent",
+    "missing_constraint",
+    "open_alternative_set",
+]);