@indexnetwork/protocol 21.0.0-rc.486.1 → 21.0.0-rc.488.1

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

@@ -1,6 +1,6 @@
 import type { Id } from '../interfaces/database.interface.js';
-import type { OpportunityGraphDeps } from '../../opportunities/application/opportunity.graph.shared.js';
-import type { OpportunityMutationOutcome } from '../../opportunities/application/opportunity.graph.modes.js';
+import type { OpportunityGraphDeps } from '../../opportunities/opportunity.graph.shared.js';
+import type { OpportunityMutationOutcome } from '../../opportunities/opportunity.graph.modes.js';
 import { z } from "zod";
 import type { ModelConfig } from "./model.config.js";
 import type { ToolScopeType } from "./tool.scope.js";
@@ -8,7 +8,7 @@ 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 { ContactServiceAdapter } from "../../contacts/ports/index.js";
+import type { ContactServiceAdapter } from "../../contacts/contact.repository.port.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";
@@ -16,7 +16,7 @@ import type { ChatSummaryReader } from "../interfaces/chat-summary.interface.js"
 import type { ChatMessageWriter } from "../interfaces/chat-message-writer.interface.js";
 import type { NegotiationSummaryReader } from "../interfaces/negotiation-summary.interface.js";
 import type { Embedder } from "../interfaces/embedder.interface.js";
-import type { AgentDatabase } from "../../agents/ports/index.js";
+import type { AgentDatabase } from "../../agents/agent.repository.port.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";

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

@@ -1,6 +1,6 @@
 import type { ToolDeps, ToolRegistry } from './tool.helpers.js';
 import type { ToolSurface } from './utility.tools.js';
-import type { OpportunityOwnerApprovalDeps } from '../../opportunities/ports/opportunity.tools.port.js';
+import type { OpportunityOwnerApprovalDeps } from '../../opportunities/opportunity.tools.port.js';
 export interface CreateToolRegistryOptions {
     /**
      * Tool-surface profile. The default `'rest'` profile (direct HTTP Tool API)

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

@@ -2,14 +2,14 @@ import { error, redactSensitiveFields } from './tool.helpers.js';
 import { createEnrichmentTools } from '../../enrichment/enrichment.tools.js';
 import { Intents } from '../../intents/intent.module.js';
 import { Networks } from '../../networks/network.module.js';
-import { createOpportunityTools } from '../../opportunities/index.js';
+import { createOpportunityTools } from '../../opportunities/opportunity.module.js';
 import { createUtilityTools } from './utility.tools.js';
-import { createContactTools } from '../../contacts/index.js';
-import { createAgentTools } from '../../agents/index.js';
-import { createNegotiationTools } from '../../negotiations/index.js';
+import { createContactTools } from '../../contacts/contact.module.js';
+import { createAgentTools } from '../../agents/agent.module.js';
+import { createNegotiationTools } from '../../negotiations/negotiation.module.js';
 import { createChatTools } from '../../chat/chat.tools.js';
 import { createPremiseTools } from '../../premises/premise.tools.js';
-import { createQuestionerTools } from '../../questions/index.js';
+import { createQuestionerTools } from '../../questions/question.module.js';
 import { protocolLogger } from '../observability/protocol.logger.js';
 import { requestContext } from '../observability/request-context.js';
 const logger = protocolLogger('ToolRegistry');

package/dist/shared/interfaces/agent-dispatcher.interface.d.ts

@@ -10,7 +10,7 @@
  * module cycle through the negotiation capability facade.
  */
 import type { NegotiationTurn, UserNegotiationContext, SeedAssessment } from '../schemas/negotiation-state.schema.js';
-import type { NegotiatorMemoryEntry } from '../../negotiations/domain/negotiation.memory.js';
+import type { NegotiatorMemoryEntry } from '../../negotiations/negotiation.memory.js';
 import type { AttributedPriorDialogue } from '../../negotiations/negotiation.attribution.js';
 import type { NegotiationPrivateConsultation } from './database.interface.js';
 import type { NegotiationContinuationTimeoutIdentity } from './negotiation-events.interface.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "21.0.0-rc.486.1",
+  "version": "21.0.0-rc.488.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

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

@@ -1,23 +0,0 @@
-/**
- * agents/application — registration, permission, and dispatch tools.
- *
- * Re-exports the application-tier entry points of the participant-agents
- * capability: the agent registration and permission management tool factory.
- *
- * ## Foreground adapters (participant-directed, authenticated)
- *
- * - {@link createAgentTools} — `read_own_agent`, `register_agent`,
- *   `list_agents`, `update_agent`, `delete_agent`, `grant_agent_permission`,
- *   `revoke_agent_permission` MCP tools for the authenticated registration
- *   and permission management path (IND-599: `read_own_agent` is the
- *   agent-principal self-read; the rest are human owner/admin actions).
- *
- * ## Boundary
- *
- * Imports from agents/domain, agents/ports, and
- * shared/ infrastructure — never from runtime/, host implementations, or
- * other capability internals.
- *
- * IND-548: canonical application layer for the participant-agents capability.
- */
-export { createAgentTools } from "./agent.tools.js";

package/dist/agents/application/index.js

@@ -1,24 +0,0 @@
-/**
- * agents/application — registration, permission, and dispatch tools.
- *
- * Re-exports the application-tier entry points of the participant-agents
- * capability: the agent registration and permission management tool factory.
- *
- * ## Foreground adapters (participant-directed, authenticated)
- *
- * - {@link createAgentTools} — `read_own_agent`, `register_agent`,
- *   `list_agents`, `update_agent`, `delete_agent`, `grant_agent_permission`,
- *   `revoke_agent_permission` MCP tools for the authenticated registration
- *   and permission management path (IND-599: `read_own_agent` is the
- *   agent-principal self-read; the rest are human owner/admin actions).
- *
- * ## Boundary
- *
- * Imports from agents/domain, agents/ports, and
- * shared/ infrastructure — never from runtime/, host implementations, or
- * other capability internals.
- *
- * IND-548: canonical application layer for the participant-agents capability.
- */
-// ── Registration and permission management tools ──────────────────────────────
-export { createAgentTools } from "./agent.tools.js";

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

@@ -1,19 +0,0 @@
-/**
- * agents/domain — pure agent entity value types and constants.
- *
- * Contains AgentRecord, AgentTransportRecord, AgentPermissionRecord,
- * AgentWithRelations, CreateAgentInput, CreateTransportInput,
- * GrantPermissionInput, and SYSTEM_AGENT_IDS.
- *
- * No application logic, no LLM calls, no cross-capability imports.
- *
- * ## What does NOT live here
- *
- * - AgentDatabase: persistence port — lives in agents/ports.
- * - AgentDispatcher: dispatch port — lives in agents/ports.
- * - createAgentTools: application layer — lives in agents/application.
- *
- * IND-548: canonical domain layer for the participant-agents capability.
- */
-export type { AgentRecord, AgentTransportRecord, AgentPermissionRecord, AgentWithRelations, CreateAgentInput, CreateTransportInput, GrantPermissionInput, } from "./agent.types.js";
-export { SYSTEM_AGENT_IDS } from "./agent.types.js";

package/dist/agents/domain/index.js

@@ -1 +0,0 @@
-export { SYSTEM_AGENT_IDS } from "./agent.types.js";

package/dist/agents/index.d.ts

@@ -1,21 +0,0 @@
-/**
- * participant-agents — the capability's sole cross-capability surface.
- *
- * Anything outside this capability imports from here and nowhere else.
- * Supersedes the capabilities/*.facade.ts + 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 { 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/agents/index.js

@@ -1,11 +0,0 @@
-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 { 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/agents/ports/index.d.ts

@@ -1,27 +0,0 @@
-/**
- * agents/ports — injected dependency contracts.
- *
- * Re-exports the narrow port types that the participant-agents module
- * declares as explicit injected boundaries.  Consumers import these to
- * wire host implementations without depending on the application layer.
- *
- * ## Port groups
- *
- * ### Persistence port
- * - AgentDatabase — agent CRUD, transport management, permission grants.
- *
- * ### Dispatch port
- * - AgentDispatcher — negotiation turn dispatch (external poller + fallback).
- * - AgentDispatchResult — dispatch outcome discriminated union.
- * - NegotiationTurnPayload — full context sent to the dispatched agent.
- *
- * ### Tool host port
- * - AgentToolDeps — host capabilities for registration/permission tools.
- *
- * IND-548: canonical ports surface for the participant-agents capability.
- * Compatibility path:
- *   - shared/interfaces/agent-dispatcher.interface.ts → re-exports from here
- */
-export type { AgentDatabase } from "./agent.repository.port.js";
-export type { AgentDispatcher, AgentDispatchResult, NegotiationTurnPayload, } from "./agent.dispatcher.port.js";
-export type { AgentToolDeps } from "./agent.tools.port.js";

package/dist/agents/ports/index.js

@@ -1,25 +0,0 @@
-/**
- * agents/ports — injected dependency contracts.
- *
- * Re-exports the narrow port types that the participant-agents module
- * declares as explicit injected boundaries.  Consumers import these to
- * wire host implementations without depending on the application layer.
- *
- * ## Port groups
- *
- * ### Persistence port
- * - AgentDatabase — agent CRUD, transport management, permission grants.
- *
- * ### Dispatch port
- * - AgentDispatcher — negotiation turn dispatch (external poller + fallback).
- * - AgentDispatchResult — dispatch outcome discriminated union.
- * - NegotiationTurnPayload — full context sent to the dispatched agent.
- *
- * ### Tool host port
- * - AgentToolDeps — host capabilities for registration/permission tools.
- *
- * IND-548: canonical ports surface for the participant-agents capability.
- * Compatibility path:
- *   - shared/interfaces/agent-dispatcher.interface.ts → re-exports from here
- */
-export {};

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

@@ -1,10 +0,0 @@
-/**
- * contacts/application — foreground adapters and application services.
- *
- * ## Exports
- *
- * ### Tool factory
- * - `createContactTools` — creates contact management MCP tools
- *   (list, remove, search).
- */
-export { createContactTools } from "./contact.tools.js";

package/dist/contacts/application/index.js

@@ -1,10 +0,0 @@
-/**
- * contacts/application — foreground adapters and application services.
- *
- * ## Exports
- *
- * ### Tool factory
- * - `createContactTools` — creates contact management MCP tools
- *   (list, remove, search).
- */
-export { createContactTools } from "./contact.tools.js";

package/dist/contacts/domain/contact.types.js

@@ -1,8 +0,0 @@
-/**
- * contacts/domain — pure contact entity value types.
- *
- * No application logic, no LLM calls, no cross-capability imports.
- *
- * IND-549: canonical domain layer for the contacts capability.
- */
-export {};

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

@@ -1,12 +0,0 @@
-/**
- * contacts/domain — pure contact entity value types and constants.
- *
- * Contains ContactEntry and ContactSearchResult.
- *
- * ## What does NOT live here
- *
- * - ContactServiceAdapter: persistence port — lives in contacts/ports.
- * - ContactToolDeps: tool host port — lives in contacts/ports.
- * - createContactTools: application layer — lives in contacts/application.
- */
-export type { ContactEntry, ContactSearchResult, } from "./contact.types.js";

package/dist/contacts/index.d.ts

@@ -1,9 +0,0 @@
-/**
- * contacts — the capability's sole cross-capability surface.
- *
- * Anything outside this capability imports from here and nowhere else.
- * Supersedes the capabilities/contacts.facade.ts + contacts/public/ pair; the
- * export list is the union of the facades it replaces, so the contract is unchanged.
- */
-export { createContactTools } from "./application/index.js";
-export type { ContactServiceAdapter, ContactToolDeps, } from "./ports/index.js";

package/dist/contacts/index.js

@@ -1,8 +0,0 @@
-/**
- * contacts — the capability's sole cross-capability surface.
- *
- * Anything outside this capability imports from here and nowhere else.
- * Supersedes the capabilities/contacts.facade.ts + contacts/public/ pair; the
- * export list is the union of the facades it replaces, so the contract is unchanged.
- */
-export { createContactTools } from "./application/index.js";

package/dist/contacts/ports/index.d.ts

@@ -1,19 +0,0 @@
-/**
- * contacts/ports — injected dependency contracts for the contacts capability.
- *
- * Re-exports the narrow port types that the contacts module declares as
- * explicit injected boundaries. Consumers import these to wire host
- * implementations without depending on the application layer.
- *
- * ## Port groups
- *
- * ### Persistence port
- * - ContactServiceAdapter — contact reads and removal: list, remove, search.
- *
- * ### Tool host port
- * - ContactToolDeps — host capabilities for contact management tools.
- *
- * IND-549: canonical ports surface for the contacts capability.
- */
-export type { ContactServiceAdapter } from "./contact.repository.port.js";
-export type { ContactToolDeps } from "./contact.tools.port.js";

package/dist/contacts/ports/index.js

@@ -1,18 +0,0 @@
-/**
- * contacts/ports — injected dependency contracts for the contacts capability.
- *
- * Re-exports the narrow port types that the contacts module declares as
- * explicit injected boundaries. Consumers import these to wire host
- * implementations without depending on the application layer.
- *
- * ## Port groups
- *
- * ### Persistence port
- * - ContactServiceAdapter — contact reads and removal: list, remove, search.
- *
- * ### Tool host port
- * - ContactToolDeps — host capabilities for contact management tools.
- *
- * IND-549: canonical ports surface for the contacts capability.
- */
-export {};

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

@@ -1,72 +0,0 @@
-/**
- * contexts/application — orchestrators, factories, and service classes.
- *
- * Re-exports the orchestration tier of the participant-context capability:
- * graph factories (LangGraph compilations), LLM service classes, and utility
- * helpers that belong to the application layer.  These are the building blocks
- * that foreground and ambient adapters compose to implement use cases.
- *
- * Boundary: application-layer only.  Imports from contexts/domain,
- * contexts/ports, and shared/ infrastructure — never from runtime/,
- * host implementations, or capability facades.
- *
- * ## Foreground use cases (onboarding / explicit enrichment)
- *
- * - {@link EnrichmentGraphFactory} — compiles the enrichment pipeline graph
- *   (scrape → decompose-premises → generate-profile → write-profile).
- *   Invoked by the foreground shell for `preview_profile`, `confirm_profile`,
- *   and `enrich_from_url` tools.
- * - {@link PremiseGraphFactory} — compiles the premise lifecycle graph
- *   (analyze → embed → dedupe → persist → index → assign-networks).
- *   Invoked by the foreground shell for premise CRUD tools.
- * - {@link UserContextGenerator} — synthesizes network-scoped context paragraphs
- *   and the global identity paragraph from the active premise set.
- *   Called by the background context-refresh adapter after premise mutations.
- *
- * ## Ambient use cases (scrape / decompose / regenerate / index)
- *
- * - {@link PremiseDecomposer} — decomposes free-text or scraped input into atomic
- *   premises.  Used inside EnrichmentGraphFactory (decompose-premises node) and
- *   standalone by the background decompose adapter.
- * - {@link PremiseAnalyzer} — Speech Act classification and felicity scoring.
- *   Used inside PremiseGraphFactory (analyze node).
- * - {@link PremiseIndexer} — scores premise relevance to a network index.
- *   Used inside PremiseGraphFactory (assign-networks node).
- * - {@link EnrichmentGenerator} — generates a structured profile from user account
- *   data via the enrichment generate-mode LLM pipeline.
- *
- * ## HyDE (Hypothetical Document Embeddings)
- *
- * HyDE is a protocol-owned technology binding that produces hypothetical
- * embedding documents for semantic retrieval.  The HyDE sub-capability is
- * participant-context-adjacent: it transforms participant context (premise text,
- * profile summary) into search-optimized representations.
- *
- * - {@link HydeGraphFactory} — compiles the full HyDE pipeline graph.
- * - {@link HydeGenerator} — generates hypothetical documents from a source text
- *   and a lens label.
- * - {@link LensInferrer} — infers retrieval lenses from a source text and optional
- *   profile context.
- * - {@link HydeValidator} — validates generated hypothetical documents against
- *   prompt-injection and out-of-scope risks.
- *
- * IND-545: canonical application home for participant-context orchestrators
- * previously spread across premises/, contexts/, enrichment/, and discovery/.
- */
-export { PremiseGraphFactory } from "../../premises/premise.graph.js";
-export { PremiseDecomposer, type PremiseDecomposerOutput, type DecomposedPremise, type ExistingPremiseRef, } from "../../premises/premise.decomposer.js";
-export { PremiseAnalyzer, type PremiseAnalyzerOutput, } from "../../premises/premise.analyzer.js";
-export { PremiseIndexer, type PremiseIndexerOutput, } from "../../premises/premise.indexer.js";
-export { EnrichmentGraphFactory, type CompiledPremiseGraph, } from "../../enrichment/enrichment.graph.js";
-export { EnrichmentGenerator, type GeneratedProfile } from "../../enrichment/enrichment.generator.js";
-export { createEnrichmentTools } from "../../enrichment/enrichment.tools.js";
-export { createPremiseTools } from "../../premises/premise.tools.js";
-export { UserContextGenerator } from "../../contexts/context.generator.js";
-export { HydeGraphFactory, type HydeLensInferrerLike, type HydeGeneratorLike, type HydeValidatorLike, type HydeGraphOptions, } from "../../discovery/index.js";
-export { HydeGenerator, type HydeGeneratorOutput, type HydeGenerateInput, } from "../../discovery/index.js";
-export { LensInferrer, type LensInferenceInput, type LensInferenceOutput, FRAME_SYSTEM_PROMPT, FrameResponseSchema, } from "../../discovery/index.js";
-export { HydeValidator, type HydeValidationDocument, type HydeValidationInput, type HydeValidationVerdict, type HydeValidationOutput, HydeValidationResponseSchema, buildHydeValidationPrompt, } from "../../discovery/index.js";
-export { computeHydeSourceTextHash, selectHydeDocumentsForGeneration } from "../../discovery/index.js";
-export { getHydeGenerationMode, type HydeGenerationMode, HYDE_FRAME_GENERATION_VERSION, } from "../../discovery/index.js";
-export { HYDE_DEFAULT_CACHE_TTL, HYDE_CORPUS_PROMPTS, } from "../../discovery/index.js";
-export { type HydeSourceFrame, HydeSourceFrameSchema, type HydeFrameRole, type HydeFrameHardConstraint, type HydeFrameNamedEntity, type HydeFrameVocabulary, HYDE_HARD_CONSTRAINT_TYPES, HYDE_NAMED_ENTITY_TYPES, } from "../../discovery/index.js";

package/dist/contexts/application/index.js

@@ -1,82 +0,0 @@
-/**
- * contexts/application — orchestrators, factories, and service classes.
- *
- * Re-exports the orchestration tier of the participant-context capability:
- * graph factories (LangGraph compilations), LLM service classes, and utility
- * helpers that belong to the application layer.  These are the building blocks
- * that foreground and ambient adapters compose to implement use cases.
- *
- * Boundary: application-layer only.  Imports from contexts/domain,
- * contexts/ports, and shared/ infrastructure — never from runtime/,
- * host implementations, or capability facades.
- *
- * ## Foreground use cases (onboarding / explicit enrichment)
- *
- * - {@link EnrichmentGraphFactory} — compiles the enrichment pipeline graph
- *   (scrape → decompose-premises → generate-profile → write-profile).
- *   Invoked by the foreground shell for `preview_profile`, `confirm_profile`,
- *   and `enrich_from_url` tools.
- * - {@link PremiseGraphFactory} — compiles the premise lifecycle graph
- *   (analyze → embed → dedupe → persist → index → assign-networks).
- *   Invoked by the foreground shell for premise CRUD tools.
- * - {@link UserContextGenerator} — synthesizes network-scoped context paragraphs
- *   and the global identity paragraph from the active premise set.
- *   Called by the background context-refresh adapter after premise mutations.
- *
- * ## Ambient use cases (scrape / decompose / regenerate / index)
- *
- * - {@link PremiseDecomposer} — decomposes free-text or scraped input into atomic
- *   premises.  Used inside EnrichmentGraphFactory (decompose-premises node) and
- *   standalone by the background decompose adapter.
- * - {@link PremiseAnalyzer} — Speech Act classification and felicity scoring.
- *   Used inside PremiseGraphFactory (analyze node).
- * - {@link PremiseIndexer} — scores premise relevance to a network index.
- *   Used inside PremiseGraphFactory (assign-networks node).
- * - {@link EnrichmentGenerator} — generates a structured profile from user account
- *   data via the enrichment generate-mode LLM pipeline.
- *
- * ## HyDE (Hypothetical Document Embeddings)
- *
- * HyDE is a protocol-owned technology binding that produces hypothetical
- * embedding documents for semantic retrieval.  The HyDE sub-capability is
- * participant-context-adjacent: it transforms participant context (premise text,
- * profile summary) into search-optimized representations.
- *
- * - {@link HydeGraphFactory} — compiles the full HyDE pipeline graph.
- * - {@link HydeGenerator} — generates hypothetical documents from a source text
- *   and a lens label.
- * - {@link LensInferrer} — infers retrieval lenses from a source text and optional
- *   profile context.
- * - {@link HydeValidator} — validates generated hypothetical documents against
- *   prompt-injection and out-of-scope risks.
- *
- * IND-545: canonical application home for participant-context orchestrators
- * previously spread across premises/, contexts/, enrichment/, and discovery/.
- */
-// ── Premise graph ─────────────────────────────────────────────────────────────
-export { PremiseGraphFactory } from "../../premises/premise.graph.js";
-// ── Premise service classes ───────────────────────────────────────────────────
-export { PremiseDecomposer, } from "../../premises/premise.decomposer.js";
-export { PremiseAnalyzer, } from "../../premises/premise.analyzer.js";
-export { PremiseIndexer, } from "../../premises/premise.indexer.js";
-// ── Enrichment graph + service classes ───────────────────────────────────────
-export { EnrichmentGraphFactory, } from "../../enrichment/enrichment.graph.js";
-export { EnrichmentGenerator } from "../../enrichment/enrichment.generator.js";
-// ── Tool factories (foreground adapters) ──────────────────────────────────────
-// These are foreground adapter entry points consumed by the tool composition root (shared/agent)
-// composition.  They accept compiled graphs and host deps through the tool-dep
-// ports and produce LangChain-compatible tool arrays.
-export { createEnrichmentTools } from "../../enrichment/enrichment.tools.js";
-export { createPremiseTools } from "../../premises/premise.tools.js";
-// ── Context synthesis ─────────────────────────────────────────────────────────
-export { UserContextGenerator } from "../../contexts/context.generator.js";
-// ── HyDE graph + service classes ─────────────────────────────────────────────
-export { HydeGraphFactory, } from "../../discovery/index.js";
-export { HydeGenerator, } from "../../discovery/index.js";
-export { LensInferrer, FRAME_SYSTEM_PROMPT, FrameResponseSchema, } from "../../discovery/index.js";
-export { HydeValidator, HydeValidationResponseSchema, buildHydeValidationPrompt, } from "../../discovery/index.js";
-// ── HyDE utilities ────────────────────────────────────────────────────────────
-export { computeHydeSourceTextHash, selectHydeDocumentsForGeneration } from "../../discovery/index.js";
-export { getHydeGenerationMode, HYDE_FRAME_GENERATION_VERSION, } from "../../discovery/index.js";
-export { HYDE_DEFAULT_CACHE_TTL, HYDE_CORPUS_PROMPTS, } from "../../discovery/index.js";
-export { HydeSourceFrameSchema, HYDE_HARD_CONSTRAINT_TYPES, HYDE_NAMED_ENTITY_TYPES, } from "../../discovery/index.js";

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

@@ -1,67 +0,0 @@
-/**
- * contexts/domain — pure participant-context contracts.
- *
- * Value types, graph-state shapes, and domain model types that define the
- * participant-context capability's domain language.
- * No LLM calls, no LangGraph edges, no host-adapter imports.
- *
- * ## Domain model
- *
- * A **Premise** is an atomic self-descriptive proposition asserted by a
- * participant about themselves (e.g. "I am a machine learning researcher").
- * Premises carry:
- *   - **Assertion**: the raw text of the proposition.
- *   - **Provenance**: how the premise was produced (explicit user assertion,
- *     social integration scrape, or auto-generation from account data) plus
- *     a confidence score derived from felicity conditions.
- *   - **Validity**: the time window during which the premise is considered
- *     current, plus a `volatile` flag marking it for automatic retraction
- *     when its `validUntil` window elapses.
- *   - **Analysis**: Speech Act classification (DECLARATIVE | ASSERTIVE) and
- *     felicity scores (authority, sincerity, clarity) recorded at creation time.
- *
- * ## Provenance invariants
- *
- * - `source: 'explicit'` — user typed or confirmed the premise directly in chat.
- * - `source: 'integration'` — derived from a social/external data source; the
- *   `sourceId` identifies the `user_socials` record that was the source of truth.
- * - `source: 'generated'` — auto-produced from account data via the enrichment
- *   generate-mode; no specific social record is the source.
- * - `confidence` is derived from average felicity scores when the PremiseAnalyzer
- *   runs; it falls back to 1.0 when no analysis is available (explicit tier).
- *
- * ## Validity / regeneration invariants
- *
- * - `volatile: false` (assertive tier default) — premise persists until explicitly
- *   retracted by the participant or an update operation.
- * - `volatile: true` (contextual tier default) — premise is automatically retracted
- *   by the background refresh job once `validUntil` has elapsed.
- * - Regeneration (triggered by the ambient enrichment adapter) replaces stale
- *   integration-sourced premises when the social source is re-scraped; it MUST
- *   NOT touch `source: 'explicit'` premises created by the participant directly.
- * - Context synthesis (UserContextGenerator) is triggered after premise writes and
- *   should treat the resulting paragraph as a derived projection — never as a source
- *   of truth for premise recovery.
- *
- * ## Policy separation
- *
- * - **Foreground adapters** (onboarding preview/confirm, explicit enrichment):
- *   managed by the tool composition root (shared/agent). They compose the
- *   EnrichmentGraphFactory and PremiseGraphFactory and pass the compiled graphs
- *   through the tool-dependency ports.
- * - **Ambient adapters** (scrape/decompose, regeneration, indexing, representation
- *   refresh): managed by the background runtime shell. They are the consumers of
- *   PremiseGraphFactory and EnrichmentGraphFactory in queue-worker mode.
- * - **Cache/enrichment/scraper/model/embedding integrations**: remain injected
- *   ports (see contexts/ports) or protocol-owned technology bindings
- *   in shared/agent and shared/hyde.
- *
- * IND-545: canonical home for participant-context domain contracts previously
- * spread across premises/, contexts/, enrichment/, and discovery/.
- * Legacy paths remain as compatibility re-exports pointing here.
- */
-export { PremiseGraphState } from "../../premises/premise.state.js";
-export { EnrichmentGraphState } from "../../enrichment/enrichment.state.js";
-export { HydeGraphState, type HydeDocumentState, type HydeDocumentOrigin, type HydeValidationStatus, } from "../../discovery/index.js";
-export type { UserContextInput, IncrementalContextInput, GlobalContextInput, GlobalIncrementalContextInput, UserContextResult, } from "../../contexts/context.generator.js";
-export type { PremiseAssertion, PremiseProvenance, PremiseAnalysis, PremiseValidity, PremiseRecord, } from "../../shared/interfaces/database.interface.js";