@indexnetwork/protocol 22.0.0-rc.499.1 → 64.0.0

package/dist/index.d.ts

@@ -1,134 +1,57 @@
-export { getModelName } from "./shared/agent/model.config.js";
-export type { ResolvedToolContext, ToolDeps, RawToolDefinition, } from "./shared/agent/tool.helpers.js";
-export { ChatContextAccessError, resolveChatContext } from "./shared/agent/tool.helpers.js";
-export { deriveAllowedNetworkIds, deriveDiscoveryNetworkIds } from "./shared/agent/tool.scope.js";
-export type { ToolScopeType } from "./shared/agent/tool.scope.js";
-export { requestContext } from "./shared/observability/request-context.js";
-export { setLoggerFactory } from "./shared/observability/log.js";
-export { setTimingWrapper } from "./shared/observability/performance.js";
-export { getToolTimeoutPolicy, invokeToolRuntime, toolRuntimeErrorToResult } from "./shared/agent/tool.runtime.js";
-export type { McpAuthResolver } from "./shared/interfaces/auth.interface.js";
-export type { Cache, CacheOptions, HydeCache, OpportunityCache } from "./shared/interfaces/cache.interface.js";
-export type { ChatSummaryReader } from "./shared/interfaces/chat-summary.interface.js";
-export type { NegotiationSummaryReader } from "./shared/interfaces/negotiation-summary.interface.js";
-export type { DiscoveryNegotiationDigest } from "./shared/schemas/negotiation-digest.schema.js";
-export { NegotiationSummarizer } from "./negotiations/negotiation.module.js";
-export type { ContactServiceAdapter } from "./contacts/contact.module.js";
-export type { ChatGraphCompositeDatabase, UserDatabase, SystemDatabase, OpportunityGraphDatabase, OpportunityControllerDatabase, OutcomeOutbox, RadarGraphDatabase, IntentGraphDatabase, HydeGraphDatabase, EnrichmentGraphDatabase, PremiseGraphDatabase, NegotiationGraphDatabase, NegotiationContinuationExecution, NegotiationContinuationReceipt, Opportunity, OpportunityActor, OpportunityStatus, AssignmentNetworkMembership, IntentNetworkFinalAssignmentResult, CreateOpportunityData, } from "./shared/interfaces/database.interface.js";
-export type { Embedder, VectorStoreOption, VectorSearchResult, HydeCandidate, HydeSearchOptions, LensEmbedding } from "./shared/interfaces/embedder.interface.js";
-export type { IntentGraphQueue } from "./shared/interfaces/queue.interface.js";
-export type { Scraper } from "./shared/interfaces/scraper.interface.js";
-export type { EnrichmentRunInput, EnrichmentRunRecord } from "./shared/interfaces/enrichment-run.interface.js";
-export type { NegotiationTimeoutQueue, AskUserExpiryPayload, NegotiationContinuationTimeoutIdentity, } from "./shared/interfaces/negotiation-events.interface.js";
-export type { AgentDispatcher, AgentDispatchResult, NegotiationTurnPayload } from "./shared/interfaces/agent-dispatcher.interface.js";
-export { SYSTEM_AGENT_IDS } from './agents/agent.module.js';
-export { ChatContextDigestSchema, type ChatContextDigest } from "./shared/schemas/chat-context.schema.js";
-export { type Question, type UnderspecificationType, type QuestionStrategy, type QuestionGenerationResult, type QuestionPurpose, type NegotiationQuestionProvenance, NegotiationQuestionCandidateSchema, type QuestionPoolPush, type QuestionRecoverySnapshot, type QuestionVoidedReason, type QuestionPoolPushRequestStatus, type QuestionPoolPushRequestReason, } from "./questions/question.module.js";
-export { McpApiKeyMetadataSchema } from "./shared/schemas/mcp-auth.schema.js";
-export type { McpAuthInput, McpResolvedIdentity, } from "./shared/schemas/mcp-auth.schema.js";
-export type { DiscoveryNegotiation } from "./shared/schemas/discovery-question.schema.js";
-export { QUESTION_BLOCK_MARKER, QUESTION_BLOCK_VERSION, QuestionBlockSchema, QuestionBlockQuestionSchema, parseQuestionMessage, serializeQuestionMessage, type QuestionBlock, type QuestionBlockQuestion, type ParsedQuestionMessage, } from "./shared/schemas/question-block.schema.js";
-export type { NetworkAssignmentMetadata } from "./shared/schemas/network-assignment.schema.js";
-export { DEFAULT_NETWORK_ASSIGNMENT_THRESHOLD, resolveAssignmentNetworkScope, buildNetworkAssignmentDecision } from "./shared/assignment/network-assignment.policy.js";
-export { ChatGraphFactory } from "./agents/agent.module.js";
-export { type ChatPersonaConfig } from "./agents/agent.module.js";
-export { NEGOTIATOR_PERSONA_ID, createNegotiatorPersona } from "./agents/agent.module.js";
-export { SIGNAL_PERSONA_ID, SIGNAL_PERSONA, } from "./agents/agent.module.js";
-export { ONBOARDING_PERSONA_ID, ONBOARDING_PERSONA, } from "./agents/agent.module.js";
-export { RadarGraphFactory } from "./opportunities/opportunity.module.js";
-export { HydeGraphFactory } from "./discovery/index.js";
-export { Networks } from "./networks/network.module.js";
-export type { IntentNetworkIndexer, NetworksDeps, NetworkToolDeps, } from "./networks/network.module.js";
-export { Intents } from "./intents/intent.module.js";
-export type { FollowUpPlan, FollowUpPlanInput, IntakeAnswer, IntakePack, IntakePackInput, IntakePackQuestion, IntakePackQuestionOption, IntakeRound, IntentIndexerOutput, IntentsDeps, IntentToolDeps, SynthesisInput, SynthesisResult, } from "./intents/intent.module.js";
-export { MaintenanceGraphFactory } from "./maintenance/maintenance.graph.js";
-export type { MaintenanceGraphDatabase, MaintenanceGraphCache, MaintenanceGraphQueue } from "./maintenance/maintenance.graph.js";
-export { NegotiationGraphFactory, negotiateCandidates } from "./negotiations/negotiation.module.js";
-export { OpportunityGraphFactory } from "./opportunities/opportunity.module.js";
-export { hasUnsupportedOpportunityClaim } from "./opportunities/opportunity.module.js";
-export type { StampNewbornOpportunitiesFn } from "./opportunities/opportunity.module.js";
-export { bindOwnerApprovalProvenance } from "./opportunities/opportunity.module.js";
-export type { OpportunityOwnerAction, OpportunityOwnerApprovalAttestation, OpportunityOwnerApprovalAuthority, OpportunityOwnerApprovalBinding, OpportunityOwnerApprovalChallenge, OpportunityOwnerApprovalDenialReason, OpportunityOwnerApprovalVerdict, OpportunityOwnerInteractionProvenance, OpportunityOwnerInteractionSurface, } from "./opportunities/opportunity.module.js";
-export { EnrichmentGraphFactory } from "./contexts/context.module.js";
-export { PremiseGraphFactory } from "./contexts/context.module.js";
-export { UserContextGenerator } from "./contexts/context.module.js";
-export { ChatTitleGenerator } from "./agents/agent.module.js";
-export { ChatInterruptClassifier } from "./agents/agent.module.js";
-export { ChatSummarizer } from "./agents/agent.module.js";
-export { HydeGenerator } from "./discovery/index.js";
-export { SuggestionGenerator } from "./agents/agent.module.js";
-export { LensInferrer } from "./discovery/index.js";
-export { NegotiationInsightsGenerator } from "./negotiations/negotiation.module.js";
-export type { NegotiationDigest } from "./negotiations/negotiation.module.js";
-export { IndexNegotiator } from "./negotiations/negotiation.module.js";
-export { NegotiationScreener } from "./negotiations/negotiation.module.js";
-export { NegotiationReflector } from "./negotiations/negotiation.module.js";
-export type { DistilledMemory, ReflectionTranscriptEntry, NegotiationReflectionInput, ChatReflectionInput, NegotiationReflectJobData, ReflectEnqueueFn } from "./negotiations/negotiation.module.js";
-export type { NegotiatorMemoryEntry } from "./negotiations/negotiation.module.js";
-export type { NegotiatorClientDmMessage, NegotiatorClientDmQuery, NegotiatorClientDmRetrieveFn } from "./negotiations/negotiation.module.js";
-export type { QuestionerInput, QuestionerEnqueuePayload, QuestionerEnqueueFn } from "./questions/question.module.js";
-export { INTENT_QUESTION_DAILY_CAP_DEFAULT } from "./questions/question.module.js";
-export { PoolDiscriminatorMiner } from "./opportunities/opportunity.module.js";
-export { PoolDiscriminatorAssigner } from "./opportunities/opportunity.module.js";
-export type { PoolDiscriminatorAssignmentInput, PoolDiscriminatorAssignedAxis } from "./opportunities/opportunity.module.js";
-export { runPoolDiscriminatorShadow } from "./opportunities/opportunity.module.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, } from "./opportunities/opportunity.module.js";
-export { poolQuestionsRanking, POOL_RERUN_DEBOUNCE_MS } from "./opportunities/opportunity.module.js";
-export { discoveryEvaluatorMinScore } from "./opportunities/opportunity.module.js";
-export { poolQuestionsVisitTrigger, POOL_VISIT_MINING_DEBOUNCE_MS } from "./opportunities/opportunity.module.js";
-export { buildPoolAdjustment, planPoolAdjustments, mergePoolAdjustment } from "./opportunities/opportunity.module.js";
-export type { PoolAdjustment, PoolAdjustmentSignal } from "./opportunities/opportunity.module.js";
-export { synthesizePoolQuestion, selectQuestionDiscriminators, toQuestionDiscriminator, BOTH_MATTER_LABEL } from "./opportunities/opportunity.module.js";
-export { poolQuestionCycleKey, buildPoolQuestionPushMessage } from "./opportunities/opportunity.module.js";
-export type { QuestionPoolDiscriminator, QuestionPoolSnapshot } from "./questions/question.module.js";
-export type { PoolCandidate, DiscriminatorMiningInput, MinedDiscriminator } from "./opportunities/opportunity.module.js";
-export { negotiationEvidenceQuestionsMode, NEGOTIATION_EVIDENCE_MAX_OPPORTUNITIES } from "./opportunities/opportunity.module.js";
-export { NegotiationEvidenceMiner } from "./opportunities/opportunity.module.js";
-export { runNegotiationEvidenceShadow } from "./opportunities/opportunity.module.js";
-export type { RawEvidenceTurn, RawEvidenceOutcome, RawEvidenceOwnerAnswer, RawEvidenceSegment } from "./opportunities/opportunity.module.js";
-export { isOutcomeQuestionsActivated, OUTCOME_MIN_INDEPENDENT_EXAMPLES, OUTCOME_MAX_CANDIDATES, OUTCOME_MAX_PUBLIC_CONTEXT_CHARS } from "./opportunities/opportunity.module.js";
-export { runOutcomeShadow } from "./opportunities/opportunity.module.js";
-export type { OutcomeLabel, OutcomeExample, OutcomeShadowResult } from "./opportunities/opportunity.module.js";
-export { OpportunityEvaluator } from "./opportunities/opportunity.module.js";
-export type { EvaluatorInput } from "./opportunities/opportunity.module.js";
-export { OpportunityPresenter, gatherPresenterContext } from "./opportunities/opportunity.module.js";
-export type { PresenterDatabase } from "./opportunities/opportunity.module.js";
-export { canUserSeeOpportunity, isActionableForViewer, validateOpportunityActors, classifyOpportunity, selectByComposition, RADAR_SOFT_TARGETS } from "./opportunities/opportunity.module.js";
-export { getPrimaryActionLabel } from "./opportunities/opportunity.module.js";
-export { computeRadarHealth } from "./opportunities/opportunity.module.js";
-export type { RadarHealthInput } from "./opportunities/opportunity.module.js";
-export { isIntroducerDiscoveryEnabled } from "./opportunities/opportunity.module.js";
-export { selectContactsForDiscovery, shouldRunIntroducerDiscovery, runIntroducerDiscovery, MAX_CONTACTS_PER_CYCLE, MAX_CANDIDATES_PER_CONTACT, INTRODUCER_DISCOVERY_SOURCE } from "./opportunities/opportunity.module.js";
-export type { IntroducerDiscoveryDatabase, IntroducerDiscoveryQueue, ContactWithIntents } from "./opportunities/opportunity.module.js";
-export { persistOpportunities } from "./opportunities/opportunity.module.js";
-export { presentOpportunity } from "./opportunities/opportunity.module.js";
-export type { UserInfo } from "./opportunities/opportunity.module.js";
-export { stripUuids, truncateAtBoundary } from "./opportunities/opportunity.module.js";
-export { stripUnsupportedOpportunityClaims } from "./opportunities/opportunity.module.js";
-export { safeFallbackSummary } from "./opportunities/opportunity.module.js";
-export { buildApiChatCardPresentationCacheKey, buildDeliveryCardPresentationCacheKey, buildRadarCardPresentationCacheKey } from "./opportunities/opportunity.module.js";
-export { getOrCreateDeliveryCardBatch } from "./opportunities/opportunity.module.js";
-export { createToolRegistry } from "./shared/agent/tool.registry.js";
-export { createEnrichmentTools } from "./contexts/context.module.js";
-export type { EnrichmentToolDeps } from "./contexts/context.module.js";
-export { AMBIENT_PARK_WINDOW_MS } from './negotiations/negotiation.module.js';
-export { normalizeTelegramHandle } from './shared/utils/telegram-handle.js';
-export { createMcpServer, buildMcpOnboardingMessage, ONBOARDING_ALLOWED } from "./mcp/mcp.server.js";
-export type { ScopedDepsFactory } from "./mcp/mcp.server.js";
-export { CANONICAL_MCP_CAPABILITY_POLICY_OPTIONS } from "./mcp/mcp.authorization-policy.js";
-export type { McpAuthorizationDenialEvent, McpAuthorizationObserver, McpCapabilityPolicyOptions, } from "./mcp/mcp.authorization-policy.js";
-export { NegotiationConsultationReasonSchema } from "./shared/schemas/negotiation-state.schema.js";
-export type { UserNegotiationContext, NegotiationTurn, NegotiationOutcome, SeedAssessment } from "./shared/schemas/negotiation-state.schema.js";
-export type { NegotiationAction, NegotiationConsultationReason, NegotiationSeat, NegotiationProtocolVersion } from "./shared/schemas/negotiation-state.schema.js";
-export type { NegotiationGraphLike } from "./negotiations/negotiation.module.js";
-export { HERMES_OWNER_DIRECTIVE, HermesNegotiationResponseSchema, allowedHermesActionsFor, buildHermesNegotiationTurn, } from "./negotiations/negotiation.module.js";
-export type { HermesNegotiationAction, HermesNegotiationResponse, } from "./negotiations/negotiation.module.js";
-export { isNegotiationTurnCapReached, expectedNegotiationSpeaker, negotiationScopeKey, readNegotiationMessages, allowedActionsFor, askUserAnswerWindowMs, configuredAskUserEnabled, isTerminalAction, isRejectLikeAction, readProtocolVersion, resolveSeat, seatViolationMessage } from "./negotiations/negotiation.module.js";
-export type { NegotiationSpeakerParticipants, NegotiationSpeakerMessage, NegotiationScopeMetadata } from "./negotiations/negotiation.module.js";
-export { assessConsultationEligibility, consultationPromptFor, negotiationConsultationPolicyMode } from "./negotiations/negotiation.module.js";
-export type { ConsultationEligibility, ConsultationEligibilityInput, NegotiationConsultationPolicyMode } from "./negotiations/negotiation.module.js";
-export { countOpenPreContactConsults } from "./negotiations/negotiation.module.js";
-export type { PreContactConsultTaskRow } from "./negotiations/negotiation.module.js";
-export { NEGOTIATION_QUESTION_GENERIC_COUNTERPARTY, NEGOTIATION_QUESTION_GENERIC_NETWORK, negotiationQuestionSettlementId, } from "./negotiations/negotiation.module.js";
-export { classifyParkedNegotiation, consumeQuestionBlockAnswers, negotiationParkAnswerId, resumeParkedNegotiation, routeAnswerRef, } from "./negotiations/negotiation.module.js";
-export type { AnswerRoute, InflightAnswerSettlementInput, InflightAnswerSettlementResult, NegotiationAnswerConsumptionPorts, NegotiationAnswerInput, NegotiationAnswerResumeOutcome, ParkClassification, QuestionBlockAnswerConsumptionInput, QuestionBlockAnswerConsumptionResult, RoutedAnswer, } from "./negotiations/negotiation.module.js";
+export { getModelName } from "./internal/shared/agent/model.config.js";
+export { ChatContextAccessError } from "./platform/runtime/errors.js";
+export { deriveAllowedNetworkIds, deriveDiscoveryNetworkIds } from "./internal/shared/agent/scope.js";
+export type { ScopeType, ScopeMembership } from "./protocol/core.js";
+export { requestContext, setRequestContextStore } from "./internal/shared/observability/request-context.js";
+export { setLoggerFactory } from "./internal/shared/observability/log.js";
+export { setTimingWrapper } from "./internal/shared/observability/performance.js";
+export type { Cache, CacheOptions, OpportunityCache } from "./platform/discovery/cache.js";
+export type { CompositeDatabase, UserDatabase, SystemDatabase, OpportunityDatabase, OpportunityControllerDatabase, RadarGraphDatabase, IntentGraphDatabase, Opportunity, OpportunityActor, OpportunityStatus, AssignmentNetworkMembership, IntentNetworkFinalAssignmentResult, CreateOpportunityData, IntentLifecycleStatus, TransitionLifecycleResult, NegotiationContextDatabase, NegotiationContextRecord, NegotiationContextOutcome, NegotiationContextTurn, } from "./platform/database.js";
+export type { Embedder, VectorStoreOption, VectorSearchResult } from "./platform/discovery/embedder.js";
+export type { IntentFollowUp } from "./platform/runtime/follow-up.js";
+export type { Scraper } from "./platform/discovery/scraper.js";
+export type { Logger, ProtocolError, ProtocolTraceEvent, RequestContext, RequestContextStore } from "./platform/runtime/observability.js";
+export { SYSTEM_AGENT_IDS } from './internal/agents/agent.types.js';
+export { ChatContextDigestSchema, type ChatContextDigest } from "./protocol/schemas/chat-context.schema.js";
+export { UnderspecificationTypeSchema } from "./protocol/schemas/underspecification.schema.js";
+export type { UnderspecificationType } from "./protocol/schemas/underspecification.schema.js";
+export type { DiscoveryNegotiation } from "./protocol/schemas/discovery-question.schema.js";
+export type { NetworkAssignmentMetadata } from "./protocol/schemas/network-assignment.schema.js";
+export type { DebugMetaAgent } from "./protocol/core.js";
+export { Negotiations } from './capabilities/negotiations.js';
+export { NEGOTIATION_MAX_TURNS, NEGOTIATION_MESSAGE_LIMIT } from './protocol/negotiation.constants.js';
+export { NEGOTIATION_GUIDANCE } from './protocol/protocol.prompt.js';
+export { CANONICAL_GUIDANCE_SUMMARY, CANONICAL_GUIDANCE_TOPICS, CANONICAL_GUIDANCE_TOPICS_CONTENT } from './protocol/protocol.prompt.js';
+export type { CanonicalGuidanceTopic } from './protocol/protocol.prompt.js';
+export { decideNegotiationOpening, decideNegotiationTurn, observeNegotiation, negotiationTurnSchema } from './protocol/negotiation.rules.js';
+export type { NegotiationAction, NegotiationOutcome, NegotiationTurn, NegotiationState, NegotiationDecision, NegotiationRejection, NegotiationOpening, NegotiationOpeningDecision } from './protocol/negotiation.rules.js';
+export type { NegotiationDatabase } from './platform/database/negotiation.js';
+export { Networks } from "./capabilities/networks.js";
+export type { NetworksDeps } from "./capabilities/networks.js";
+export { Intents } from "./capabilities/intents.js";
+export type { PrepareAnswer, PrepareInput, PrepareResult, RecoveryField, RecoveryFieldKind, RecoveryFieldOption, IntentsDeps, IntentSemanticMetadata, PreparedIntent, } from "./capabilities/intents.js";
+export { normalizeTelegramHandle } from './internal/shared/utils/telegram-handle.js';
+/**
+ * opportunity — the capability's sole cross-capability surface.
+ *
+ * Anything outside this capability imports from here and nowhere else.
+ * Supersedes the capabilities/*.facade.ts + opportunities/public/ pair; the export
+ * list is the union of the facades it replaces, so the contract is unchanged.
+ */
+export { pairKeyOf, } from "./internal/opportunities/opportunity.counterparties.js";
+export type { OpportunityEvidence } from "./protocol/schemas/network-assignment.schema.js";
+export type { CreateIntentCounterpartyData, OpenedNegotiation, } from "./internal/opportunities/opportunity.counterparties.js";
+export { gatherPresenterContext, OpportunityPresenter, } from "./internal/opportunities/opportunity.presentation.js";
+export type { PresenterDatabase, } from "./internal/opportunities/opportunity.presentation.js";
+export { hasUnsupportedOpportunityClaim, stripUnsupportedOpportunityClaims, stripUnsupportedOpportunityClaims as stripUnsupportedOpportunityClaimsText, } from "./internal/shared/utils/claim-safety.js";
+export { getPrimaryActionLabel, } from "./internal/opportunities/opportunity.labels.js";
+export { buildApiChatCardPresentationCacheKey, buildRadarCardPresentationCacheKey, } from "./internal/opportunities/opportunity.presentation.js";
+export { presentOpportunity, stripUuids, truncateAtBoundary, } from "./internal/opportunities/opportunity.presentation.js";
+export type { UserInfo, } from "./internal/opportunities/opportunity.presentation.js";
+export { DEFAULT_FALLBACK_HEADLINE, safeFallbackSummary, } from "./internal/opportunities/opportunity.presentation.js";
+export { canUserSeeOpportunity, classifyOpportunity, isActionableForViewer, RADAR_SOFT_TARGETS, selectByComposition, validateOpportunityActors, } from "./internal/opportunities/opportunity.utils.js";
+export { RadarGraphFactory, } from "./internal/opportunities/radar/radar.graph.js";
+export { readOpportunities } from './internal/opportunities/opportunity.graph.modes.js';
+export { admitOpportunityEvent, projectOpportunity } from './internal/opportunities/opportunity.events.js';
+export type { OpportunityAdmission, OpportunityEventType, OpportunityLogEvent, OpportunityProjection, OpportunityProjectionStatus } from './internal/opportunities/opportunity.events.js';
+export { resolveDiscoveryNetworkScope, renderDiscoveryNetworkContext } from './protocol/discovery.rules.js';

package/dist/index.js

@@ -7,117 +7,53 @@
 // surface is reviewable and changes are intentional.
 //
 // Stability tiers are defined in STABILITY.md. In short:
-//   • Stable       — Interfaces, Graph factories, Agents, the tool/runtime
-//                    helpers, and shared schemas.
+//   • Stable       — Interfaces, Graph factories, Agents, and shared schemas.
 //   • Experimental — Sections marked @experimental below (advanced graph state
 //                    types and internal helpers); may change in a minor release.
 // =============================================================================
 // ─── Public API (recommended for external consumers) ──────────────────────────
-export { getModelName } from "./shared/agent/model.config.js";
-export { ChatContextAccessError, resolveChatContext } from "./shared/agent/tool.helpers.js";
-export { deriveAllowedNetworkIds, deriveDiscoveryNetworkIds } from "./shared/agent/tool.scope.js";
-export { requestContext } from "./shared/observability/request-context.js";
-export { setLoggerFactory } from "./shared/observability/log.js";
-export { setTimingWrapper } from "./shared/observability/performance.js";
-export { getToolTimeoutPolicy, invokeToolRuntime, toolRuntimeErrorToResult } from "./shared/agent/tool.runtime.js";
-export { NegotiationSummarizer } from "./negotiations/negotiation.module.js";
-export { SYSTEM_AGENT_IDS } from './agents/agent.module.js';
+export { getModelName } from "./internal/shared/agent/model.config.js";
+export { ChatContextAccessError } from "./platform/runtime/errors.js";
+export { deriveAllowedNetworkIds, deriveDiscoveryNetworkIds } from "./internal/shared/agent/scope.js";
+export { requestContext, setRequestContextStore } from "./internal/shared/observability/request-context.js";
+export { setLoggerFactory } from "./internal/shared/observability/log.js";
+export { setTimingWrapper } from "./internal/shared/observability/performance.js";
+export { SYSTEM_AGENT_IDS } from './internal/agents/agent.types.js';
 // ─── Shared schemas ───────────────────────────────────────────────────────────
-export { ChatContextDigestSchema } from "./shared/schemas/chat-context.schema.js";
-export { NegotiationQuestionCandidateSchema, } from "./questions/question.module.js";
-export { McpApiKeyMetadataSchema } from "./shared/schemas/mcp-auth.schema.js";
-export { QUESTION_BLOCK_MARKER, QUESTION_BLOCK_VERSION, QuestionBlockSchema, QuestionBlockQuestionSchema, parseQuestionMessage, serializeQuestionMessage, } from "./shared/schemas/question-block.schema.js";
-export { DEFAULT_NETWORK_ASSIGNMENT_THRESHOLD, resolveAssignmentNetworkScope, buildNetworkAssignmentDecision } from "./shared/assignment/network-assignment.policy.js";
-// ─── Graph factories ──────────────────────────────────────────────────────────
-export { ChatGraphFactory } from "./agents/agent.module.js";
-export { NEGOTIATOR_PERSONA_ID, createNegotiatorPersona } from "./agents/agent.module.js";
-export { SIGNAL_PERSONA_ID, SIGNAL_PERSONA, } from "./agents/agent.module.js";
-export { ONBOARDING_PERSONA_ID, ONBOARDING_PERSONA, } from "./agents/agent.module.js";
-export { RadarGraphFactory } from "./opportunities/opportunity.module.js";
-export { HydeGraphFactory } from "./discovery/index.js";
+export { ChatContextDigestSchema } from "./protocol/schemas/chat-context.schema.js";
+export { UnderspecificationTypeSchema } from "./protocol/schemas/underspecification.schema.js";
+export { Negotiations } from './capabilities/negotiations.js';
+export { NEGOTIATION_MAX_TURNS, NEGOTIATION_MESSAGE_LIMIT } from './protocol/negotiation.constants.js';
+export { NEGOTIATION_GUIDANCE } from './protocol/protocol.prompt.js';
+export { CANONICAL_GUIDANCE_SUMMARY, CANONICAL_GUIDANCE_TOPICS, CANONICAL_GUIDANCE_TOPICS_CONTENT } from './protocol/protocol.prompt.js';
+export { decideNegotiationOpening, decideNegotiationTurn, observeNegotiation, negotiationTurnSchema } from './protocol/negotiation.rules.js';
 // ─── Networks ─────────────────────────────────────────────────────────────────
 // The whole capability behind one class: the community lifecycle graph, the
-// membership graph, signal assignment, and the agent-facing tools.
-export { Networks } from "./networks/network.module.js";
+// membership graph, and signal assignment.
+export { Networks } from "./capabilities/networks.js";
 // ─── Intents ──────────────────────────────────────────────────────────────────
-// The whole capability behind one class: lifecycle graph, verification,
-// network indexing, guided intake, and the agent-facing tools.
-export { Intents } from "./intents/intent.module.js";
-export { MaintenanceGraphFactory } from "./maintenance/maintenance.graph.js";
-export { NegotiationGraphFactory, negotiateCandidates } from "./negotiations/negotiation.module.js";
-export { OpportunityGraphFactory } from "./opportunities/opportunity.module.js";
-export { hasUnsupportedOpportunityClaim } from "./opportunities/opportunity.module.js";
-export { bindOwnerApprovalProvenance } from "./opportunities/opportunity.module.js";
-export { EnrichmentGraphFactory } from "./contexts/context.module.js";
-export { PremiseGraphFactory } from "./contexts/context.module.js";
+// The whole capability behind one class: lifecycle graph, verification, and
+// payload preparation.
+export { Intents } from "./capabilities/intents.js";
 // ─── Agents ───────────────────────────────────────────────────────────────────
-export { UserContextGenerator } from "./contexts/context.module.js";
-export { ChatTitleGenerator } from "./agents/agent.module.js";
-export { ChatInterruptClassifier } from "./agents/agent.module.js";
-export { ChatSummarizer } from "./agents/agent.module.js";
-export { HydeGenerator } from "./discovery/index.js";
-export { SuggestionGenerator } from "./agents/agent.module.js";
-export { LensInferrer } from "./discovery/index.js";
-export { NegotiationInsightsGenerator } from "./negotiations/negotiation.module.js";
-export { IndexNegotiator } from "./negotiations/negotiation.module.js";
-export { NegotiationScreener } from "./negotiations/negotiation.module.js";
-export { NegotiationReflector } from "./negotiations/negotiation.module.js";
-export { INTENT_QUESTION_DAILY_CAP_DEFAULT } from "./questions/question.module.js";
-export { PoolDiscriminatorMiner } from "./opportunities/opportunity.module.js";
-export { PoolDiscriminatorAssigner } from "./opportunities/opportunity.module.js";
-export { runPoolDiscriminatorShadow } from "./opportunities/opportunity.module.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, } from "./opportunities/opportunity.module.js";
-export { poolQuestionsRanking, POOL_RERUN_DEBOUNCE_MS } from "./opportunities/opportunity.module.js";
-// Discovery env accessors (IND-XXX)
-export { discoveryEvaluatorMinScore } from "./opportunities/opportunity.module.js";
-export { poolQuestionsVisitTrigger, POOL_VISIT_MINING_DEBOUNCE_MS } from "./opportunities/opportunity.module.js";
-export { buildPoolAdjustment, planPoolAdjustments, mergePoolAdjustment } from "./opportunities/opportunity.module.js";
-export { synthesizePoolQuestion, selectQuestionDiscriminators, toQuestionDiscriminator, BOTH_MATTER_LABEL } from "./opportunities/opportunity.module.js";
-export { poolQuestionCycleKey, buildPoolQuestionPushMessage } from "./opportunities/opportunity.module.js";
-// Lens C — negotiation-evidence questions (IND-433, shadow).
-export { negotiationEvidenceQuestionsMode, NEGOTIATION_EVIDENCE_MAX_OPPORTUNITIES } from "./opportunities/opportunity.module.js";
-export { NegotiationEvidenceMiner } from "./opportunities/opportunity.module.js";
-export { runNegotiationEvidenceShadow } from "./opportunities/opportunity.module.js";
-// Lens B — outcome-question shadow (IND-434)
-export { isOutcomeQuestionsActivated, OUTCOME_MIN_INDEPENDENT_EXAMPLES, OUTCOME_MAX_CANDIDATES, OUTCOME_MAX_PUBLIC_CONTEXT_CHARS } from "./opportunities/opportunity.module.js";
-export { runOutcomeShadow } from "./opportunities/opportunity.module.js";
-export { OpportunityEvaluator } from "./opportunities/opportunity.module.js";
-export { OpportunityPresenter, gatherPresenterContext } from "./opportunities/opportunity.module.js";
-// ─── Support utilities ────────────────────────────────────────────────────────
-export { canUserSeeOpportunity, isActionableForViewer, validateOpportunityActors, classifyOpportunity, selectByComposition, RADAR_SOFT_TARGETS } from "./opportunities/opportunity.module.js";
-export { getPrimaryActionLabel } from "./opportunities/opportunity.module.js";
-export { computeRadarHealth } from "./opportunities/opportunity.module.js";
-export { isIntroducerDiscoveryEnabled } from "./opportunities/opportunity.module.js";
-export { selectContactsForDiscovery, shouldRunIntroducerDiscovery, runIntroducerDiscovery, MAX_CONTACTS_PER_CYCLE, MAX_CANDIDATES_PER_CONTACT, INTRODUCER_DISCOVERY_SOURCE } from "./opportunities/opportunity.module.js";
-export { persistOpportunities } from "./opportunities/opportunity.module.js";
-export { presentOpportunity } from "./opportunities/opportunity.module.js";
-export { stripUuids, truncateAtBoundary } from "./opportunities/opportunity.module.js";
-export { stripUnsupportedOpportunityClaims } from "./opportunities/opportunity.module.js";
-export { safeFallbackSummary } from "./opportunities/opportunity.module.js";
-export { buildApiChatCardPresentationCacheKey, buildDeliveryCardPresentationCacheKey, buildRadarCardPresentationCacheKey } from "./opportunities/opportunity.module.js";
-export { getOrCreateDeliveryCardBatch } from "./opportunities/opportunity.module.js";
-// ─── Tools ────────────────────────────────────────────────────────────────────
-export { createToolRegistry } from "./shared/agent/tool.registry.js";
-// Capability-owned tool entry points. These are explicit, narrow contracts;
-// capability implementation directories remain private to the package.
-export { createEnrichmentTools } from "./contexts/context.module.js";
-export { AMBIENT_PARK_WINDOW_MS } from './negotiations/negotiation.module.js';
-export { normalizeTelegramHandle } from './shared/utils/telegram-handle.js';
-// ─── MCP ──────────────────────────────────────────────────────────────────────
-export { createMcpServer, buildMcpOnboardingMessage, ONBOARDING_ALLOWED } from "./mcp/mcp.server.js";
-export { CANONICAL_MCP_CAPABILITY_POLICY_OPTIONS } from "./mcp/mcp.authorization-policy.js";
-// ─── States (for advanced graph consumers) ────────────────────────────────────
-// @experimental — internal graph-state shapes; may change in a minor release.
-export { NegotiationConsultationReasonSchema } from "./shared/schemas/negotiation-state.schema.js";
-export { HERMES_OWNER_DIRECTIVE, HermesNegotiationResponseSchema, allowedHermesActionsFor, buildHermesNegotiationTurn, } from "./negotiations/negotiation.module.js";
-// ─── Negotiation seat rules (v2 client-advocate protocol) ───────────────────
-export { isNegotiationTurnCapReached, expectedNegotiationSpeaker, negotiationScopeKey, readNegotiationMessages, allowedActionsFor, askUserAnswerWindowMs, configuredAskUserEnabled, isTerminalAction, isRejectLikeAction, readProtocolVersion, resolveSeat, seatViolationMessage } from "./negotiations/negotiation.module.js";
-export { assessConsultationEligibility, consultationPromptFor, negotiationConsultationPolicyMode } from "./negotiations/negotiation.module.js";
-// The pre-contact park predicate (#1445), re-exported for the radar read path:
-// the "asking you first" state is the same open-consult recognition the
-// per-signal cap performs, so both sides must read the stamp through one
-// function rather than two copies of the same JSON walk.
-export { countOpenPreContactConsults } from "./negotiations/negotiation.module.js";
-export { NEGOTIATION_QUESTION_GENERIC_COUNTERPARTY, NEGOTIATION_QUESTION_GENERIC_NETWORK, negotiationQuestionSettlementId, } from "./negotiations/negotiation.module.js";
-// ─── Negotiation answer consumption (conversational questions) ──────────────
-export { classifyParkedNegotiation, consumeQuestionBlockAnswers, negotiationParkAnswerId, resumeParkedNegotiation, routeAnswerRef, } from "./negotiations/negotiation.module.js";
+export { normalizeTelegramHandle } from './internal/shared/utils/telegram-handle.js';
+// ─── Opportunity compatibility exports ─────────────────────────────────────
+/**
+ * opportunity — the capability's sole cross-capability surface.
+ *
+ * Anything outside this capability imports from here and nowhere else.
+ * Supersedes the capabilities/*.facade.ts + opportunities/public/ pair; the export
+ * list is the union of the facades it replaces, so the contract is unchanged.
+ */
+export { pairKeyOf, } from "./internal/opportunities/opportunity.counterparties.js";
+export { gatherPresenterContext, OpportunityPresenter, } from "./internal/opportunities/opportunity.presentation.js";
+export { hasUnsupportedOpportunityClaim, stripUnsupportedOpportunityClaims, stripUnsupportedOpportunityClaims as stripUnsupportedOpportunityClaimsText, } from "./internal/shared/utils/claim-safety.js";
+export { getPrimaryActionLabel, } from "./internal/opportunities/opportunity.labels.js";
+export { buildApiChatCardPresentationCacheKey, buildRadarCardPresentationCacheKey, } from "./internal/opportunities/opportunity.presentation.js";
+export { presentOpportunity, stripUuids, truncateAtBoundary, } from "./internal/opportunities/opportunity.presentation.js";
+export { DEFAULT_FALLBACK_HEADLINE, safeFallbackSummary, } from "./internal/opportunities/opportunity.presentation.js";
+export { canUserSeeOpportunity, classifyOpportunity, isActionableForViewer, RADAR_SOFT_TARGETS, selectByComposition, validateOpportunityActors, } from "./internal/opportunities/opportunity.utils.js";
+export { RadarGraphFactory, } from "./internal/opportunities/radar/radar.graph.js";
+export { readOpportunities } from './internal/opportunities/opportunity.graph.modes.js';
+export { admitOpportunityEvent, projectOpportunity } from './internal/opportunities/opportunity.events.js';
+export { resolveDiscoveryNetworkScope, renderDiscoveryNetworkContext } from './protocol/discovery.rules.js';

package/dist/internal/agents/agent.repository.port.d.ts

@@ -0,0 +1,59 @@
+/**
+ * agents/ports — AgentDatabase persistence port.
+ *
+ * Injected boundary for agent registry persistence. Implemented by the
+ * host application and passed into the protocol layer at the composition root.
+ */
+import type { AgentRecord, CreateAgentInput } from "./agent.types.js";
+/**
+ * Database adapter interface for agent registry operations.
+ *
+ * Handles CRUD for the agents a user owns, plus reading the single agent the
+ * owner selected to handle negotiations. Implemented by the host application
+ * and injected into the protocol layer at the composition root.
+ */
+export interface AgentDatabase {
+    /**
+     * Creates a new agent record.
+     * @param input - Agent creation parameters.
+     * @returns The persisted agent record.
+     */
+    createAgent(input: CreateAgentInput): Promise<AgentRecord>;
+    /**
+     * Retrieves an agent by its ID.
+     * @param agentId - The agent UUID.
+     * @returns The agent record, or null if not found.
+     */
+    getAgent(agentId: string): Promise<AgentRecord | null>;
+    /**
+     * Updates mutable fields on an agent.
+     * @param agentId - The agent UUID.
+     * @param updates - Partial set of fields to update.
+     * @returns The updated agent record, or null if not found.
+     */
+    updateAgent(agentId: string, updates: Partial<Pick<AgentRecord, 'name' | 'description' | 'status' | 'metadata'>>): Promise<AgentRecord | null>;
+    /**
+     * Deletes an agent.
+     * @param agentId - The agent UUID.
+     */
+    deleteAgent(agentId: string): Promise<void>;
+    /**
+     * Lists all agents owned by a user.
+     * @param userId - The owner's user ID.
+     * @returns Array of agents.
+     */
+    listAgentsForUser(userId: string): Promise<AgentRecord[]>;
+    /**
+     * Reads the single agent the owner selected to handle negotiations.
+     * @param ownerId - The owner's user ID.
+     * @returns The selected negotiator, or null when none is selected.
+     */
+    getSelectedNegotiator(ownerId: string): Promise<AgentRecord | null>;
+    /**
+     * Returns the well-known IDs for built-in system agents.
+     * @returns Object mapping system agent roles to their fixed UUIDs.
+     */
+    getSystemAgentIds(): {
+        negotiator: string;
+    };
+}

package/dist/internal/agents/agent.repository.port.js

@@ -0,0 +1,7 @@
+/**
+ * agents/ports — AgentDatabase persistence port.
+ *
+ * Injected boundary for agent registry persistence. Implemented by the
+ * host application and passed into the protocol layer at the composition root.
+ */
+export {};

package/dist/internal/agents/agent.types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * agents/domain — pure agent entity types.
+ *
+ * These are the core value-objects for the participant-agents capability:
+ * agent records and the well-known system agent ID constants.
+ *
+ * No application logic, no LLM calls, no cross-capability imports.
+ */
+export interface AgentRecord {
+    id: string;
+    ownerId: string;
+    name: string;
+    description: string | null;
+    type: 'external' | 'system';
+    status: 'active' | 'inactive';
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface CreateAgentInput {
+    ownerId: string;
+    name: string;
+    description?: string;
+    type: 'external' | 'system';
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Fixed UUIDs for built-in system agents.
+ *
+ * These are seeded into the database on first run and must never change,
+ * as they are referenced by foreign keys and hard-coded in protocol logic.
+ */
+export declare const SYSTEM_AGENT_IDS: {
+    readonly negotiator: "00000000-0000-0000-0000-000000000002";
+};

package/dist/{agents → internal/agents}/agent.types.js

@@ -2,13 +2,9 @@
  * agents/domain — pure agent entity types.
  *
  * These are the core value-objects for the participant-agents capability:
- * agent records, transport channels, permission grants, and the well-known
- * system agent ID constants.
+ * agent records and the well-known system agent ID constants.
  *
  * No application logic, no LLM calls, no cross-capability imports.
- *
- * IND-548: canonical home for agent entity types previously in
- * shared/interfaces/agent.interface.ts.
  */
 /**
  * Fixed UUIDs for built-in system agents.
@@ -17,6 +13,5 @@
  * as they are referenced by foreign keys and hard-coded in protocol logic.
  */
 export const SYSTEM_AGENT_IDS = {
-    chatOrchestrator: '00000000-0000-0000-0000-000000000001',
     negotiator: '00000000-0000-0000-0000-000000000002',
 };