@indexnetwork/protocol 10.1.1-rc.451.1 → 10.1.3-rc.453.1

package/CHANGELOG.md

@@ -29,6 +29,7 @@ pin a supported release, use `latest`.
 ## [Unreleased]
 
 ### Removed
+- Remove six unsupported tool-port forwarding shims and the deprecated unused discovery-question mapper; stable package-root exports remain unchanged.
 - Remove the onboarding privacy-consent layer (10.0.0). The
   `record_onboarding_privacy_consent` tool is gone from the tool registry, the
   onboarding persona/prompt, the MCP authorization matrix and onboarding
@@ -67,6 +68,7 @@ pin a supported release, use `latest`.
   `SynthesisResult` types. Minor bump: additive surface only.
 
 ### Changed
+- Remove unsupported deprecated source/deep forwarding shims after migrating repository consumers to canonical modules; stable package-root exports are unchanged.
 - Add a fail-closed isolated provider-free test gate (10.1.1). Tooling-only
   safety foundation; no runtime or public API behavior changes.
 - Share capability classification metadata between the existing architecture

package/IMPLEMENTATION.md

@@ -18,6 +18,10 @@ deep imports are not part of the contract. Every symbol is re-exported explicitl
 See [STABILITY.md](./STABILITY.md) for the full policy and the deprecation path,
 and [CHANGELOG.md](./CHANGELOG.md) for release history.
 
+Internal source is domain-first: `signals`, `communities`, `questions`,
+`participant-agents`, `contacts`, and `integrations`; opportunity and negotiation
+place state/contracts in `domain/` and workflows/tools in `application/`.
+
 ## Source-map publication policy
 
 Published `@indexnetwork/protocol` tarballs contain **no source maps**: neither
@@ -94,7 +98,6 @@ The package defines interfaces — your application provides the concrete implem
 | `AgentDispatcher` | Resolves and invokes personal agents during negotiation turns — required to register the negotiation tools |
 | `McpAuthResolver` | Resolves `{ userId, agentId }` from an incoming MCP HTTP request (MCP server only) |
 | `DeliveryLedger` | Commits OpenClaw opportunity-delivery rows |
-| `DiscoveryRunStore` / `DiscoveryRunQueue` | Persist and execute async MCP discovery runs |
 | `EnrichmentRunStore` / `EnrichmentRunQueue` | Persist and execute async MCP enrichment runs |
 | `MintConnectLink` | Mints short connect links for opportunity accepts |
 | `ChatSummaryReader` | Read-through chat-session digest |
@@ -138,7 +141,6 @@ const tools = await createChatTools({
   agentDatabase,        // AgentDatabase — agent registry
   agentDispatcher,      // AgentDispatcher — routes negotiation turns to personal agents
   deliveryLedger,       // DeliveryLedger — OpenClaw delivery commits
-  discoveryRuns,        // DiscoveryRunStore (+ discoveryRunQueue) — async MCP discovery
   enrichmentRuns,       // EnrichmentRunStore (+ enrichmentRunQueue) — async MCP enrichment runs
   mintConnectLink,      // short connect links for opportunity accepts
   modelConfig,          // override chat model / reasoning effort (see above)
@@ -148,10 +150,9 @@ const tools = await createChatTools({
 ```
 
 `createChatTools` accepts a single `ToolContext` object. The required adapters
-above are always needed; the optional capabilities default to a degraded-but-
-functional mode when omitted (e.g. without `agentDispatcher` the negotiation
-tools are not registered, and without `discoveryRuns` MCP discovery runs
-synchronously).
+above are always needed; optional capabilities default to a degraded-but-
+functional mode when omitted (for example, without `agentDispatcher` the
+negotiation tools are not registered).
 
 ## Graphs
 
@@ -181,7 +182,7 @@ Each factory takes its typed dependencies in the constructor and exposes a
 |---|---|
 | `ChatGraphFactory` | ReAct chat loop — LLM calls tools, responds to the user |
 | `IntentGraphFactory` | Clarify, infer, verify felicity, reconcile, and persist intents |
-| `OpportunityGraphFactory` | HyDE-based discovery: search, evaluate (valency), rank, persist |
+| `OpportunityGraphFactory` | Background matching: search, evaluate (valency), rank, persist |
 | `EnrichmentGraphFactory` | Enrich users (scrape + embed) and decompose into premises |
 | `PremiseGraphFactory` | Decompose and index a user's premises |
 | `NegotiationGraphFactory` | Multi-turn bilateral negotiation flows |

package/dist/capabilities/opportunities.facade.d.ts

@@ -4,8 +4,7 @@
  * The list is curated by responsibility (discovery, lifecycle, presentation,
  * and question lenses) rather than exposing the opportunity directory.
  *
- * IND-551: canonical paths updated to opportunity/domain and
- * opportunity/application; shims remain at old flat paths for compatibility.
+ * IND-551: canonical paths use opportunity/domain and opportunity/application.
  */
 export { RadarGraphFactory } from "../opportunity/radar/radar.graph.js";
 export { OpportunityGraphFactory } from "../opportunity/application/opportunity.graph.js";
@@ -17,7 +16,7 @@ export type { EvaluatorInput } from "../opportunity/application/opportunity.eval
 export { OpportunityPresenter, gatherPresenterContext } from "../opportunity/application/opportunity.presenter.js";
 export type { PresenterDatabase } from "../opportunity/application/opportunity.presenter.js";
 export { createOpportunityTools } from "../opportunity/application/opportunity.tools.js";
-export type { OpportunityToolDeps } from "./opportunities.tools.port.js";
+export type { OpportunityToolDeps } from "../opportunity/ports/index.js";
 export { discoveryAllowedTypes, discoveryIntentMatchingEnabled, discoveryProfileMatchingEnabled, discoveryProfileSource, resetDiscoveryEnvWarningsForTests, } from "../opportunity/discovery.env.js";
 export type { DiscoveryMatchType, DiscoveryProfileSource } from "../opportunity/discovery.env.js";
 export { PoolDiscriminatorMiner } from "../opportunity/discriminator/discriminator.miner.js";

package/dist/capabilities/opportunities.facade.js

@@ -4,8 +4,7 @@
  * The list is curated by responsibility (discovery, lifecycle, presentation,
  * and question lenses) rather than exposing the opportunity directory.
  *
- * IND-551: canonical paths updated to opportunity/domain and
- * opportunity/application; shims remain at old flat paths for compatibility.
+ * IND-551: canonical paths use opportunity/domain and opportunity/application.
  */
 // ── Core graphs ───────────────────────────────────────────────────────────────
 export { RadarGraphFactory } from "../opportunity/radar/radar.graph.js";

package/dist/capabilities/opportunities.safety.facade.d.ts

@@ -1,2 +1,2 @@
 /** Narrow opportunities safety port for text that may leave another capability. */
-export { hasUnsupportedOpportunityClaim, stripUnsupportedOpportunityClaims } from "../opportunity/opportunity.claim-safety.js";
+export { hasUnsupportedOpportunityClaim, stripUnsupportedOpportunityClaims } from "../opportunity/domain/opportunity.claim-safety.js";

package/dist/capabilities/opportunities.safety.facade.js

@@ -1,2 +1,2 @@
 /** Narrow opportunities safety port for text that may leave another capability. */
-export { hasUnsupportedOpportunityClaim, stripUnsupportedOpportunityClaims } from "../opportunity/opportunity.claim-safety.js";
+export { hasUnsupportedOpportunityClaim, stripUnsupportedOpportunityClaims } from "../opportunity/domain/opportunity.claim-safety.js";

package/dist/chat/chat.agent.d.ts

@@ -242,9 +242,8 @@ export declare class ChatAgent {
      */
     private executeToolCalls;
     /**
-     * Check whether any tool call produced valid opportunity blocks.
-     * Both `discover_opportunities` and `list_opportunities` can return
-     * ```opportunity code blocks — either one counts as a valid source.
+     * Check whether `list_opportunities` returned valid opportunity blocks.
+     * Persisted cards from that tool are the only valid source.
      */
     private static hasOpportunitySource;
     /**
@@ -278,7 +277,7 @@ export declare class ChatAgent {
     private static readonly STEP_NAME_MAX;
     /**
      * Post-process a tool result: strip _graphTimings, extract summary/debugSteps,
-     * and optionally run discover_opportunities → create_intent callback.
+     * and optionally normalize a tool result before a create_intent callback.
      *
      * Returns the normalized result string and extracted debug metadata so both
      * the normal streaming tool loop and the hallucination-recovery branch

package/dist/chat/chat.agent.js

@@ -359,9 +359,8 @@ export class ChatAgent {
         return results;
     }
     /**
-     * Check whether any tool call produced valid opportunity blocks.
-     * Both `discover_opportunities` and `list_opportunities` can return
-     * ```opportunity code blocks — either one counts as a valid source.
+     * Check whether `list_opportunities` returned valid opportunity blocks.
+     * Persisted cards from that tool are the only valid source.
      */
     static hasOpportunitySource(toolsUsed) {
         return toolsUsed.some((t) => t.name === "list_opportunities" &&
@@ -431,7 +430,7 @@ export class ChatAgent {
     }
     /**
      * Post-process a tool result: strip _graphTimings, extract summary/debugSteps,
-     * and optionally run discover_opportunities → create_intent callback.
+     * and optionally normalize a tool result before a create_intent callback.
      *
      * Returns the normalized result string and extracted debug metadata so both
      * the normal streaming tool loop and the hallucination-recovery branch

package/dist/contacts/index.d.ts

@@ -6,19 +6,14 @@
  * contacts/ports; this barrel is for cross-capability consumers that must
  * go through the contacts public surface.
  *
- * IND-549: canonical home for contact management capabilities previously
- * spread across contact/, shared/interfaces/contact.interface.ts, and
- * capabilities/contacts.tools.port.ts.
+ * IND-549: canonical home for contact management capabilities.
  *
  * Retains participant reachability semantics: all operations are scoped to
  * the owning user's personal network. Contacts are participants with whom
  * opportunity discovery is run.
  *
- * Legacy paths:
- * - contact/contact.tools.ts — thin compatibility shim → contacts/application
- * - contact/contact.inviter.ts — thin compatibility shim → contacts/application
+ * Compatibility paths:
  * - shared/interfaces/contact.interface.ts — thin compatibility shim → contacts/ports
- * - capabilities/contacts.tools.port.ts — thin compatibility shim → contacts/ports
  * - capabilities/contacts.facade.ts — thin re-export via contacts/public
  */
 export * from "./public/index.js";

package/dist/contacts/index.js

@@ -6,19 +6,14 @@
  * contacts/ports; this barrel is for cross-capability consumers that must
  * go through the contacts public surface.
  *
- * IND-549: canonical home for contact management capabilities previously
- * spread across contact/, shared/interfaces/contact.interface.ts, and
- * capabilities/contacts.tools.port.ts.
+ * IND-549: canonical home for contact management capabilities.
  *
  * Retains participant reachability semantics: all operations are scoped to
  * the owning user's personal network. Contacts are participants with whom
  * opportunity discovery is run.
  *
- * Legacy paths:
- * - contact/contact.tools.ts — thin compatibility shim → contacts/application
- * - contact/contact.inviter.ts — thin compatibility shim → contacts/application
+ * Compatibility paths:
  * - shared/interfaces/contact.interface.ts — thin compatibility shim → contacts/ports
- * - capabilities/contacts.tools.port.ts — thin compatibility shim → contacts/ports
  * - capabilities/contacts.facade.ts — thin re-export via contacts/public
  */
 export * from "./public/index.js";

package/dist/contacts/ports/contact.tools.port.d.ts

@@ -11,9 +11,8 @@
  * from shared/interfaces/contact.interface.ts, which after IND-549 forwards
  * to contacts/ports — creating a cycle back here.
  *
- * Structural equivalence with the Pick<ToolRegistryCompositionDeps,
- * "contactService" | "contactsEnabled"> definition in the legacy shim is
- * preserved.
+ * Its shape remains structurally equivalent to the matching
+ * ToolRegistryCompositionDeps fields.
  *
  * IND-549: extracted from capabilities/contacts.tools.port.ts into the
  * contacts capability's dedicated ports layer.

package/dist/contacts/ports/contact.tools.port.js

@@ -11,9 +11,8 @@
  * from shared/interfaces/contact.interface.ts, which after IND-549 forwards
  * to contacts/ports — creating a cycle back here.
  *
- * Structural equivalence with the Pick<ToolRegistryCompositionDeps,
- * "contactService" | "contactsEnabled"> definition in the legacy shim is
- * preserved.
+ * Its shape remains structurally equivalent to the matching
+ * ToolRegistryCompositionDeps fields.
  *
  * IND-549: extracted from capabilities/contacts.tools.port.ts into the
  * contacts capability's dedicated ports layer.

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

@@ -14,9 +14,8 @@
  * - ContactToolDeps — host capabilities for contact management tools.
  *
  * IND-549: canonical ports surface for the contacts capability.
- * Legacy paths:
+ * Legacy path:
  *   - shared/interfaces/contact.interface.ts → re-exports types from here
- *   - capabilities/contacts.tools.port.ts → re-exports ContactToolDeps from here
  */
 export type { ContactServiceAdapter } from "./contact.repository.port.js";
 export type { ContactToolDeps } from "./contact.tools.port.js";

package/dist/contacts/ports/index.js

@@ -14,8 +14,7 @@
  * - ContactToolDeps — host capabilities for contact management tools.
  *
  * IND-549: canonical ports surface for the contacts capability.
- * Legacy paths:
+ * Legacy path:
  *   - shared/interfaces/contact.interface.ts → re-exports types from here
- *   - capabilities/contacts.tools.port.ts → re-exports ContactToolDeps from here
  */
 export {};

package/dist/integrations/index.d.ts

@@ -6,9 +6,7 @@
  * or integrations/ports; this barrel is for cross-capability consumers that
  * must go through the integrations public surface.
  *
- * IND-549: canonical home for integration capabilities previously spread
- * across integration/, shared/interfaces/integration.interface.ts, and
- * capabilities/integrations.tools.port.ts.
+ * IND-549: canonical home for integration capabilities.
  *
  * Retains host-integration configuration/actions semantics: the module owns
  * the OAuth session lifecycle and bulk contact import pipeline contracts.
@@ -18,10 +16,8 @@
  * Allowed outbound capability dependencies: none (empty set). The integrations
  * module is a leaf capability that only depends on shared/ primitives.
  *
- * Legacy paths:
- * - integration/integration.tools.ts — thin compatibility shim → integrations/application
+ * Compatibility paths:
  * - shared/interfaces/integration.interface.ts — thin compatibility shim → integrations/ports
- * - capabilities/integrations.tools.port.ts — thin compatibility shim → integrations/ports
  * - capabilities/integrations.facade.ts — thin re-export via integrations/public
  */
 export * from "./public/index.js";

package/dist/integrations/index.js

@@ -6,9 +6,7 @@
  * or integrations/ports; this barrel is for cross-capability consumers that
  * must go through the integrations public surface.
  *
- * IND-549: canonical home for integration capabilities previously spread
- * across integration/, shared/interfaces/integration.interface.ts, and
- * capabilities/integrations.tools.port.ts.
+ * IND-549: canonical home for integration capabilities.
  *
  * Retains host-integration configuration/actions semantics: the module owns
  * the OAuth session lifecycle and bulk contact import pipeline contracts.
@@ -18,10 +16,8 @@
  * Allowed outbound capability dependencies: none (empty set). The integrations
  * module is a leaf capability that only depends on shared/ primitives.
  *
- * Legacy paths:
- * - integration/integration.tools.ts — thin compatibility shim → integrations/application
+ * Compatibility paths:
  * - shared/interfaces/integration.interface.ts — thin compatibility shim → integrations/ports
- * - capabilities/integrations.tools.port.ts — thin compatibility shim → integrations/ports
  * - capabilities/integrations.facade.ts — thin re-export via integrations/public
  */
 export * from "./public/index.js";

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

@@ -19,9 +19,8 @@
  * - IntegrationToolDeps — host capabilities for integration-backed tools.
  *
  * IND-549: canonical ports surface for the integrations capability.
- * Legacy paths:
+ * Legacy path:
  *   - shared/interfaces/integration.interface.ts → re-exports types from here
- *   - capabilities/integrations.tools.port.ts → re-exports IntegrationToolDeps from here
  */
 export type { IntegrationAdapter } from "./integration.adapter.port.js";
 export type { IntegrationImporter, IntegrationImportResult } from "./integration.importer.port.js";

package/dist/integrations/ports/index.js

@@ -19,8 +19,7 @@
  * - IntegrationToolDeps — host capabilities for integration-backed tools.
  *
  * IND-549: canonical ports surface for the integrations capability.
- * Legacy paths:
+ * Legacy path:
  *   - shared/interfaces/integration.interface.ts → re-exports types from here
- *   - capabilities/integrations.tools.port.ts → re-exports IntegrationToolDeps from here
  */
 export {};

package/dist/integrations/ports/integration.tools.port.d.ts

@@ -11,9 +11,8 @@
  * shared/interfaces/integration.interface.ts, which after IND-549 forwards
  * to integrations/ports — creating a cycle back here.
  *
- * Structural equivalence with the Pick<ToolRegistryCompositionDeps,
- * "integration" | "integrationImporter" | "contactsEnabled"> definition in
- * the legacy shim is preserved.
+ * Its shape remains structurally equivalent to the matching
+ * ToolRegistryCompositionDeps fields.
  *
  * IND-549: extracted from capabilities/integrations.tools.port.ts into the
  * integrations capability's dedicated ports layer.

package/dist/integrations/ports/integration.tools.port.js

@@ -11,9 +11,8 @@
  * shared/interfaces/integration.interface.ts, which after IND-549 forwards
  * to integrations/ports — creating a cycle back here.
  *
- * Structural equivalence with the Pick<ToolRegistryCompositionDeps,
- * "integration" | "integrationImporter" | "contactsEnabled"> definition in
- * the legacy shim is preserved.
+ * Its shape remains structurally equivalent to the matching
+ * ToolRegistryCompositionDeps fields.
  *
  * IND-549: extracted from capabilities/integrations.tools.port.ts into the
  * integrations capability's dedicated ports layer.

package/dist/maintenance/maintenance.graph.js

@@ -9,8 +9,8 @@
 import { StateGraph, START, END } from '@langchain/langgraph';
 import { MaintenanceGraphState } from './maintenance.state.js';
 import { computeRadarHealth } from '../opportunity/radar/radar.health.js';
-import { canUserSeeOpportunity, classifyOpportunity, isActionableForViewer, RADAR_SOFT_TARGETS } from '../opportunity/opportunity.utils.js';
-import { shouldRunIntroducerDiscovery, runIntroducerDiscovery } from '../opportunity/opportunity.introducer.js';
+import { canUserSeeOpportunity, classifyOpportunity, isActionableForViewer, RADAR_SOFT_TARGETS } from '../opportunity/domain/opportunity.utils.js';
+import { shouldRunIntroducerDiscovery, runIntroducerDiscovery } from '../opportunity/application/opportunity.introducer.js';
 import { isIntroducerDiscoveryEnabled } from '../opportunity/application/opportunity.introducer-feature.js';
 import { protocolLogger } from '../shared/observability/protocol.logger.js';
 const logger = protocolLogger('MaintenanceGraph');

package/dist/negotiation/index.d.ts

@@ -21,29 +21,5 @@
  * └── index.ts      — this file
  * ```
  *
- * ## Legacy paths (thin inward shims)
- *
- * The following old flat-file paths are preserved as thin re-export shims for
- * backward compatibility with test files and runtime composition:
- * - negotiation/negotiation.state.ts → domain
- * - negotiation/negotiation.protocol.ts → domain
- * - negotiation/negotiation.deadlock.ts → domain
- * - negotiation/negotiation.deadlock.contracts.ts → domain
- * - negotiation/negotiation.lifecycle-narration.ts → domain
- * - negotiation/negotiation.task-lock-policy.ts → domain
- * - negotiation/negotiation.intent-snapshot-provenance.ts → domain
- * - negotiation/negotiation.consultation-policy.ts → domain
- * - negotiation/negotiation.question-safety.ts → domain
- * - negotiation/negotiation.memory.ts → domain
- * - negotiation/negotiation.graph.ts → application
- * - negotiation/negotiation.agent.ts → application
- * - negotiation/negotiation.screen.ts → application (+ screen contracts from domain)
- * - negotiation/negotiation.reflect.ts → application
- * - negotiation/negotiation.summarizer.ts → application
- * - negotiation/negotiation.tools.ts → application
- * - negotiation/negotiation.detail-reader.ts → application
- * - negotiation/insight.generator.ts → application
- * - capabilities/negotiation*.facade.ts → public surface
- * - capabilities/negotiation.tools.port.ts → ports
  */
 export * from "./public/index.js";

package/dist/negotiation/index.js

@@ -21,29 +21,5 @@
  * └── index.ts      — this file
  * ```
  *
- * ## Legacy paths (thin inward shims)
- *
- * The following old flat-file paths are preserved as thin re-export shims for
- * backward compatibility with test files and runtime composition:
- * - negotiation/negotiation.state.ts → domain
- * - negotiation/negotiation.protocol.ts → domain
- * - negotiation/negotiation.deadlock.ts → domain
- * - negotiation/negotiation.deadlock.contracts.ts → domain
- * - negotiation/negotiation.lifecycle-narration.ts → domain
- * - negotiation/negotiation.task-lock-policy.ts → domain
- * - negotiation/negotiation.intent-snapshot-provenance.ts → domain
- * - negotiation/negotiation.consultation-policy.ts → domain
- * - negotiation/negotiation.question-safety.ts → domain
- * - negotiation/negotiation.memory.ts → domain
- * - negotiation/negotiation.graph.ts → application
- * - negotiation/negotiation.agent.ts → application
- * - negotiation/negotiation.screen.ts → application (+ screen contracts from domain)
- * - negotiation/negotiation.reflect.ts → application
- * - negotiation/negotiation.summarizer.ts → application
- * - negotiation/negotiation.tools.ts → application
- * - negotiation/negotiation.detail-reader.ts → application
- * - negotiation/insight.generator.ts → application
- * - capabilities/negotiation*.facade.ts → public surface
- * - capabilities/negotiation.tools.port.ts → ports
  */
 export * from "./public/index.js";

package/dist/negotiation/negotiation.attribution.d.ts

@@ -1,4 +1,4 @@
-import type { NegotiationTurn } from "./negotiation.state.js";
+import type { NegotiationTurn } from "./domain/negotiation.state.js";
 /**
  * Prior-dialogue attribution (IND-569).
  *

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

@@ -12,7 +12,5 @@
  *   negotiationDatabase, agentDispatcher (optional), negotiationTimeoutQueue (optional).
  *
  * IND-550: canonical ports surface for the negotiation capability.
- * Legacy paths:
- *   - capabilities/negotiation.tools.port.ts → re-exports NegotiationToolDeps from here
  */
 export type { NegotiationToolDeps } from "./negotiation.tools.port.js";

package/dist/negotiation/ports/index.js

@@ -12,7 +12,5 @@
  *   negotiationDatabase, agentDispatcher (optional), negotiationTimeoutQueue (optional).
  *
  * IND-550: canonical ports surface for the negotiation capability.
- * Legacy paths:
- *   - capabilities/negotiation.tools.port.ts → re-exports NegotiationToolDeps from here
  */
 export {};

package/dist/negotiation/ports/negotiation.tools.port.d.ts

@@ -9,7 +9,6 @@ import type { NegotiationTimeoutQueue } from "../../shared/interfaces/negotiatio
  * same pattern as contacts/ports/contact.tools.port.ts.
  *
  * IND-550: canonical port type for negotiation tool host dependencies.
- * Legacy path (capabilities/negotiation.tools.port.ts) re-exports from here.
  */
 export interface NegotiationToolDeps {
     negotiationDatabase: NegotiationGraphDatabase;

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

@@ -2230,15 +2230,15 @@ export class OpportunityGraphFactory {
                     // represented user (from-introducer, via onBehalfOfUserId).
                     initiatorUserId: discoveryUserId,
                     onCandidateResolved });
-                // MCP-only: race the whole negotiate phase against a budget. When the
-                // timer wins we return early with a `timed_out` trace; the unresolved
-                // promise keeps running in the Bun event loop and each candidate's
-                // finalize node updates its opp status in the DB. We deliberately do
-                // NOT await it, NOT abort it, and NOT mutate state.opportunities —
-                // the MCP tool handler refreshes statuses from the DB before
-                // responding. Bounded blast radius: at most ~20 s of background work
-                // per request; orphans heal via maintenance scripts or IND-279 when
-                // it lands.
+                // Optionally bound this opportunity-matching continuation phase. When
+                // the timer wins, return a `timed_out` trace while the unresolved
+                // continuation keeps running in the Bun event loop; each candidate's
+                // finalize node persists its opportunity status in the DB. Deliberately
+                // do NOT await it, abort it, or add unfinished results to
+                // state.opportunities: later opportunity reads observe the persisted
+                // continuation state. The budget limits this invocation's wait, not
+                // background matching work; orphans heal via maintenance scripts or
+                // IND-279 when it lands.
                 const budgetMs = state.options.negotiateTimeoutMs;
                 let acceptedResults;
                 if (budgetMs !== undefined) {

package/dist/opportunity/application/opportunity.tools.d.ts

@@ -1,5 +1,5 @@
 import type { DefineTool } from "../../shared/agent/tool.helpers.js";
-import type { OpportunityToolDeps } from "../../capabilities/opportunities.tools.port.js";
+import type { OpportunityToolDeps } from "../ports/index.js";
 export { buildOpportunityPresentation } from "./opportunity.card-presentation.js";
 import type { Opportunity } from "../../shared/interfaces/database.interface.js";
 /**

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

@@ -14,7 +14,6 @@
  * - Cache key builders (opportunity.presentation-cache.ts)
  * - Discovery-run coalescing (opportunity.discovery-run-coalescing.ts)
  * - Negotiation-summary mappers (negotiation-summary.builder.ts)
- * - Discovery question input helper (discovery-question.helper.ts)
  *
  * ## What lives in subdirectories (exported by path, not moved)
  * - discriminator/ — pool discriminator types, env, scorer, adjustments, question, push
@@ -34,7 +33,6 @@ export * from "./opportunity.presentation.js";
 export * from "./opportunity.safe-presentation.js";
 export * from "./opportunity.presentation-cache.js";
 export * from "./negotiation-summary.builder.js";
-export * from "./discovery-question.helper.js";
 export type { PoolCandidate, DiscriminatorMiningInput, MinedDiscriminator, ScoredDiscriminator, VerifiedAssignment, DiscriminatorShadowResult, } from "../discriminator/discriminator.types.js";
 export { poolQuestionsMiningMode, poolQuestionsMode, poolQuestionsPushMode, poolQuestionsStampNewborn, POOL_DISCRIMINATOR_MIN_POOL_SIZE, POOL_DISCRIMINATOR_MAX_CANDIDATES, POOL_DISCRIMINATOR_MAX_PUBLIC_CONTEXT_CHARS, POOL_QUESTION_MIN_VOI, POOL_QUESTION_MAX_PENDING_PER_INTENT, poolQuestionsRanking, POOL_RERUN_DEBOUNCE_MS, poolQuestionsVisitTrigger, POOL_VISIT_MINING_DEBOUNCE_MS, } from "../discriminator/discriminator.env.js";
 export { buildPoolAdjustment, planPoolAdjustments, mergePoolAdjustment, readActivePoolAdjustments, adjustedConfidence, } from "../discriminator/discriminator.adjustments.js";

package/dist/opportunity/domain/index.js

@@ -14,7 +14,6 @@
  * - Cache key builders (opportunity.presentation-cache.ts)
  * - Discovery-run coalescing (opportunity.discovery-run-coalescing.ts)
  * - Negotiation-summary mappers (negotiation-summary.builder.ts)
- * - Discovery question input helper (discovery-question.helper.ts)
  *
  * ## What lives in subdirectories (exported by path, not moved)
  * - discriminator/ — pool discriminator types, env, scorer, adjustments, question, push
@@ -35,7 +34,6 @@ export * from "./opportunity.presentation.js";
 export * from "./opportunity.safe-presentation.js";
 export * from "./opportunity.presentation-cache.js";
 export * from "./negotiation-summary.builder.js";
-export * from "./discovery-question.helper.js";
 export { poolQuestionsMiningMode, poolQuestionsMode, poolQuestionsPushMode, poolQuestionsStampNewborn, POOL_DISCRIMINATOR_MIN_POOL_SIZE, POOL_DISCRIMINATOR_MAX_CANDIDATES, POOL_DISCRIMINATOR_MAX_PUBLIC_CONTEXT_CHARS, POOL_QUESTION_MIN_VOI, POOL_QUESTION_MAX_PENDING_PER_INTENT, poolQuestionsRanking, POOL_RERUN_DEBOUNCE_MS, poolQuestionsVisitTrigger, POOL_VISIT_MINING_DEBOUNCE_MS, } from "../discriminator/discriminator.env.js";
 export { buildPoolAdjustment, planPoolAdjustments, mergePoolAdjustment, readActivePoolAdjustments, adjustedConfidence, } from "../discriminator/discriminator.adjustments.js";
 export { synthesizePoolQuestion, selectQuestionDiscriminators, toQuestionDiscriminator, BOTH_MATTER_LABEL, } from "../discriminator/discriminator.question.js";

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

@@ -131,12 +131,12 @@ export interface OpportunityGraphOptions {
     /** Chat session ID for draft opportunities; stored as context.conversationId for visibility filtering. */
     conversationId?: string;
     /**
-     * MCP-only: cap the negotiate-phase wall-clock at this many milliseconds.
+     * Cap the negotiate-phase wall-clock at this many milliseconds.
      * When set, `negotiateNode` races `negotiateCandidates(...)` against a timer;
      * if the timer wins, the node returns early with a `timed_out` trace and the
-     * unawaited negotiation chains finalize each opp's DB status in the
-     * background. Set to 20_000 by the MCP `discover_opportunities` handler.
-     * Chat, ambient queue, and all other callers omit this — existing behavior.
+     * unawaited negotiation chains finalize each opportunity's DB status in the
+     * background. Foreground callers omit this; background matching supplies it
+     * only where its bounded execution requires it.
      */
     negotiateTimeoutMs?: number;
 }

package/dist/opportunity/index.d.ts

@@ -25,13 +25,5 @@
  * - negotiation-evidence/ — Lens C evidence extraction and mining
  * - outcome/ — Lens B outcome hypothesis mining
  * - radar/ — radar graph (flat presenter-card list) and radar health
- *
- * ## Legacy paths (thin inward shims)
- * The following old flat-file paths are preserved as thin re-export shims for
- * backward compatibility with test files and runtime composition. All shims
- * delegate to opportunity/domain or opportunity/application.
- *
- * IND-551 completion gate: remove compatibility shims only after an approved
- * deprecation/SemVer plan is in place.
  */
 export * from "./public/index.js";

package/dist/opportunity/index.js

@@ -25,13 +25,5 @@
  * - negotiation-evidence/ — Lens C evidence extraction and mining
  * - outcome/ — Lens B outcome hypothesis mining
  * - radar/ — radar graph (flat presenter-card list) and radar health
- *
- * ## Legacy paths (thin inward shims)
- * The following old flat-file paths are preserved as thin re-export shims for
- * backward compatibility with test files and runtime composition. All shims
- * delegate to opportunity/domain or opportunity/application.
- *
- * IND-551 completion gate: remove compatibility shims only after an approved
- * deprecation/SemVer plan is in place.
  */
 export * from "./public/index.js";

package/dist/opportunity/radar/radar.graph.js

@@ -12,12 +12,12 @@
  */
 import { StateGraph, START, END } from '@langchain/langgraph';
 import { RadarGraphState } from './radar.state.js';
-import { OpportunityPresenter, gatherPresenterContext } from '../opportunity.presenter.js';
-import { loadNegotiationContext } from '../negotiation-context.loader.js';
-import { canUserSeeOpportunity, isActionableForViewer, selectByComposition } from '../opportunity.utils.js';
-import { getPrimaryActionLabel, SECONDARY_ACTION_LABEL } from '../opportunity.labels.js';
-import { safeFallbackSummary } from '../opportunity.safe-presentation.js';
-import { buildRadarCardPresentationCacheKey } from '../opportunity.presentation-cache.js';
+import { OpportunityPresenter, gatherPresenterContext } from '../application/opportunity.presenter.js';
+import { loadNegotiationContext } from '../application/negotiation-context.loader.js';
+import { canUserSeeOpportunity, isActionableForViewer, selectByComposition } from '../domain/opportunity.utils.js';
+import { getPrimaryActionLabel, SECONDARY_ACTION_LABEL } from '../domain/opportunity.labels.js';
+import { safeFallbackSummary } from '../domain/opportunity.safe-presentation.js';
+import { buildRadarCardPresentationCacheKey } from '../domain/opportunity.presentation-cache.js';
 import { protocolLogger } from '../../shared/observability/protocol.logger.js';
 import { timed } from '../../shared/observability/performance.js';
 import { requestContext } from "../../shared/observability/request-context.js";

package/dist/opportunity/radar/radar.health.js

@@ -1,4 +1,4 @@
-import { RADAR_SOFT_TARGETS } from '../opportunity.utils.js';
+import { RADAR_SOFT_TARGETS } from '../domain/opportunity.utils.js';
 const WEIGHT_COMPOSITION = 0.4;
 const WEIGHT_FRESHNESS = 0.3;
 const WEIGHT_EXPIRATION = 0.3;

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

@@ -12,13 +12,10 @@
  * shared/interfaces/agent.interface.ts, and
  * shared/interfaces/agent-dispatcher.interface.ts.
  *
- * Legacy paths:
- * - agent/* — thin compatibility shims pointing to participant-agents/application
+ * Compatibility paths:
  * - shared/interfaces/agent.interface.ts — re-exports from participant-agents/domain
  *   and participant-agents/ports
  * - shared/interfaces/agent-dispatcher.interface.ts — re-exports from
  *   participant-agents/ports
- * - capabilities/participant-agents.tools.port.ts — re-exports AgentToolDeps
- *   from participant-agents/ports
  */
 export * from "./public/index.js";