@indexnetwork/protocol 17.0.1-rc.480.1 → 19.0.0-rc.482.1

package/dist/intents/intent.module.js

@@ -0,0 +1,103 @@
+/**
+ * intents — the capability's single public surface.
+ *
+ * Everything the rest of the package (and every host) may reach lives on the
+ * {@link Intents} class. The directories beside this file are private
+ * implementation, grouped by what they do rather than by layer:
+ *
+ *   graph/               the lifecycle graph — prep, infer, verify, reconcile, execute
+ *   intake/              the guided first-signal interview
+ *   intent.inferrer      an utterance into candidate signals
+ *   intent.reconciler    candidate signals into create/update/expire actions
+ *   intent.verifier      felicity and entropy verdicts
+ *   intent.clarifier     the clarification path when a signal is underspecified
+ *   intent.indexer       scoring one signal against one network
+ *   intent.proposal      the persisted proposal record and description normalization
+ *   intent.tools         the agent-facing tool definitions
+ *
+ * Only the two multi-file stages keep a directory. Nothing outside `intents/`
+ * imports any of it; the layout may change freely as long as this class keeps
+ * its shape.
+ */
+import { IntentGraphFactory } from "./graph/intent.graph.js";
+import { IntentIndexer } from "./intent.indexer.js";
+import { FALLBACK_WHO_QUESTION, SignalIntakeOrchestrator } from "./intake/intake.orchestrator.js";
+import { SignalIntakePackGenerator } from "./intake/intake.pack.generator.js";
+import { normalizeIntentDescription } from "./intent.proposal.js";
+import { createIntentTools } from "./intent.tools.js";
+import { SemanticVerifier } from "./intent.verifier.js";
+/**
+ * The intents capability.
+ *
+ * One instance is cheap: the model-backed collaborators behind each method are
+ * constructed on first use and then reused, so a host can hold a single
+ * `Intents` and call only the parts it needs without paying for the rest.
+ */
+export class Intents {
+    constructor(deps = {}) {
+        this.deps = deps;
+    }
+    // ── Lifecycle graph ─────────────────────────────────────────────────────────
+    /**
+     * Build the intent lifecycle graph — load, infer, verify, reconcile, execute.
+     *
+     * @throws If the instance was constructed without a `database`.
+     */
+    createGraph() {
+        const { database, embedder, queue, questionerEnqueue, agents } = this.deps;
+        if (!database) {
+            throw new Error("Intents.createGraph() requires a `database` dependency.");
+        }
+        return new IntentGraphFactory(database, embedder, queue, questionerEnqueue, agents).createGraph();
+    }
+    // ── Verification ────────────────────────────────────────────────────────────
+    /**
+     * Verify one utterance against the speaker's profile — felicity conditions,
+     * speech-act classification, semantic entropy, and specificity.
+     *
+     * @param content - The raw utterance.
+     * @param profileContext - The speaker's profile, serialized as JSON.
+     */
+    async verifyIntent(content, profileContext) {
+        this.verifier ?? (this.verifier = new SemanticVerifier());
+        return this.verifier.invoke(content, profileContext);
+    }
+    // ── Indexing ────────────────────────────────────────────────────────────────
+    /**
+     * Score how well one signal fits one network, from the network's purpose and
+     * the member's sharing preferences.
+     *
+     * @returns Scores and reasoning, or `null` when the model call fails.
+     */
+    async indexIntent(intent, indexPrompt, memberPrompt, sourceName, networkContext) {
+        this.indexer ?? (this.indexer = new IntentIndexer());
+        return this.indexer.invoke(intent, indexPrompt, memberPrompt, sourceName, networkContext);
+    }
+    // ── Guided intake ───────────────────────────────────────────────────────────
+    /** Generate a participant's intake brief and round-1 question. */
+    async generateIntakePack(input) {
+        this.packGenerator ?? (this.packGenerator = new SignalIntakePackGenerator());
+        return this.packGenerator.generate(input);
+    }
+    /** Plan and write the next intake follow-up questions. */
+    async generateIntakeFollowUps(input) {
+        this.orchestrator ?? (this.orchestrator = new SignalIntakeOrchestrator());
+        return this.orchestrator.generateFollowUps(input);
+    }
+    /** Turn answered intake rounds into a signal description and card summary. */
+    async synthesizeIntake(input) {
+        this.orchestrator ?? (this.orchestrator = new SignalIntakeOrchestrator());
+        return this.orchestrator.synthesize(input);
+    }
+    /** Normalize a signal description to its persisted form. */
+    static normalizeDescription(description) {
+        return normalizeIntentDescription(description);
+    }
+    /** Register the agent-facing intent tools against a tool definer. */
+    static createTools(defineTool, deps) {
+        return createIntentTools(defineTool, deps);
+    }
+}
+// ── Stateless surface ───────────────────────────────────────────────────────
+/** The static round-1 question used when pack generation is unavailable. */
+Intents.FALLBACK_INTAKE_QUESTION = FALLBACK_WHO_QUESTION;

package/dist/intents/{domain/intent.proposal.d.ts → intent.proposal.d.ts}

@@ -1,3 +1,5 @@
+/** Default user-facing warning for broad attributive intent proposals. */
+export declare const DEFAULT_SPECIFICITY_WARNING = "This signal is broad and may produce many weak matches. Add a more concrete role, outcome, location, timeframe, domain, or specific need to get better recommendations.";
 /** Verifier output retained verbatim across the host persistence boundary. */
 export interface IntentProposalVerifierOutput {
     reasoning: string;

package/dist/intents/{domain/intent.proposal.js → intent.proposal.js}

@@ -1,3 +1,5 @@
+/** Default user-facing warning for broad attributive intent proposals. */
+export const DEFAULT_SPECIFICITY_WARNING = "This signal is broad and may produce many weak matches. Add a more concrete role, outcome, location, timeframe, domain, or specific need to get better recommendations.";
 /** Normalize intent text exactly as the direct graph write path does. */
 export function normalizeIntentDescription(description) {
     if (!description || typeof description !== "string")

package/dist/intents/{application/intent.reconciler.js → intent.reconciler.js}

@@ -10,10 +10,10 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 import { HumanMessage, SystemMessage } from "@langchain/core/messages";
 import { tool } from "@langchain/core/tools";
 import { z } from "zod";
-import { protocolLogger } from "../../shared/observability/protocol.logger.js";
-import { Timed } from "../../shared/observability/performance.js";
-import { createStructuredModel } from "../../shared/agent/model.config.js";
-import { invokeWithAbortSignal } from "../../shared/agent/model-signal.js";
+import { protocolLogger } from "../shared/observability/protocol.logger.js";
+import { Timed } from "../shared/observability/performance.js";
+import { createStructuredModel } from "../shared/agent/model.config.js";
+import { invokeWithAbortSignal } from "../shared/agent/model-signal.js";
 const logger = protocolLogger("IntentReconciler");
 const invokeLog = protocolLogger("IntentReconciler:invoke");
 const CreateActionTypeSchema = z.union([z.literal("create"), z.literal("CREATE")]);

package/dist/intents/{application/intent.tools.d.ts → intent.tools.d.ts}

@@ -1,7 +1,10 @@
 import { IntentClarifier } from "./intent.clarifier.js";
-import type { ExecutionResult, IntentValidationFailure } from "../domain/intent.state.js";
-import type { DefineTool } from "../../shared/agent/tool.helpers.js";
-import type { IntentToolDeps } from "../ports/signals.tools.port.js";
+import type { ExecutionResult, IntentValidationFailure } from "./graph/intent.graph.state.js";
+import type { DefineTool, ToolRegistryCompositionDeps } from "../shared/agent/tool.helpers.js";
+/** Host capabilities consumed by signal and intent tools. */
+export type IntentToolDeps = Pick<ToolRegistryCompositionDeps, "userDb" | "systemDb"> & Pick<ToolRegistryCompositionDeps, "intentProposalStore"> & {
+    graphs: Pick<ToolRegistryCompositionDeps["graphs"], "intent" | "intentIndex" | "profile">;
+};
 type IntentClarifierLike = Pick<IntentClarifier, "invoke">;
 /** Replace the lazy clarifier in deterministic tool tests. */
 export declare function setIntentClarifierForTesting(clarifier: IntentClarifierLike | null): void;

package/dist/intents/{application/intent.tools.js → intent.tools.js}

@@ -1,12 +1,11 @@
 import { z } from "zod";
 import { IntentClarifier } from "./intent.clarifier.js";
-import { DEFAULT_SPECIFICITY_WARNING } from "../domain/signal.specificity.js";
-import { normalizeIntentDescription } from "../domain/intent.proposal.js";
-import { protocolLogger } from "../../shared/observability/protocol.logger.js";
-import { traceGraph } from "../../shared/observability/trace.js";
-import { success, error, UUID_REGEX } from "../../shared/agent/tool.helpers.js";
-import { invokeWithAbortSignal } from "../../shared/agent/model-signal.js";
-import { deriveAllowedNetworkIds, focusedIntentId, focusedNetworkId, focusedNetworkLabel } from "../../shared/agent/tool.scope.js";
+import { DEFAULT_SPECIFICITY_WARNING, normalizeIntentDescription } from "./intent.proposal.js";
+import { protocolLogger } from "../shared/observability/protocol.logger.js";
+import { traceGraph } from "../shared/observability/trace.js";
+import { success, error, UUID_REGEX } from "../shared/agent/tool.helpers.js";
+import { invokeWithAbortSignal } from "../shared/agent/model-signal.js";
+import { deriveAllowedNetworkIds, focusedIntentId, focusedNetworkId, focusedNetworkLabel } from "../shared/agent/tool.scope.js";
 const logger = protocolLogger("ChatTools:Intent");
 let intentClarifier;
 function getIntentClarifier() {

package/dist/intents/{application/intent.verifier.js → intent.verifier.js}

@@ -10,10 +10,10 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 import { HumanMessage, SystemMessage } from "@langchain/core/messages";
 import { tool } from "@langchain/core/tools";
 import { z } from "zod";
-import { protocolLogger } from "../../shared/observability/protocol.logger.js";
-import { Timed } from "../../shared/observability/performance.js";
-import { createStructuredModel } from "../../shared/agent/model.config.js";
-import { invokeWithAbortSignal } from "../../shared/agent/model-signal.js";
+import { protocolLogger } from "../shared/observability/protocol.logger.js";
+import { Timed } from "../shared/observability/performance.js";
+import { createStructuredModel } from "../shared/agent/model.config.js";
+import { invokeWithAbortSignal } from "../shared/agent/model-signal.js";
 const logger = protocolLogger("SemanticVerifier");
 const invokeLog = protocolLogger("SemanticVerifier:invoke");
 const referentialBreadthSchema = z.enum(["narrow", "moderate", "broad"]);

package/dist/networks/application/indexer.graph.d.ts

@@ -1,6 +1,6 @@
 import type { IntentNetworkGraphDatabase } from "../ports/index.js";
 import type { DebugMetaAgent } from "../../agents/index.js";
-import type { IntentIndexer } from "../ports/index.js";
+import type { IntentNetworkIndexer } from "../ports/index.js";
 import { IntentNetworkGraphState, type AssignmentResult } from "./indexer.state.js";
 /**
  * Factory class to build and compile the Intent–Network (indexer) Graph.
@@ -12,9 +12,9 @@ import { IntentNetworkGraphState, type AssignmentResult } from "./indexer.state.
  *
  * ## Signal assignment policy
  *
- * The `IntentIndexer` is injected at construction time from the signals public
- * facade via the communities ports layer — this factory never imports signals
- * application internals directly.
+ * The indexer is injected at construction time via the communities ports layer,
+ * which narrows the intents module to the one method used here — this factory
+ * never reaches intents internals directly.
  *
  * Two assignment paths:
  * 1. Direct (`skipEvaluation: true`):
@@ -23,7 +23,7 @@ import { IntentNetworkGraphState, type AssignmentResult } from "./indexer.state.
  *    - Loads intent + network context (indexPrompt, memberPrompt).
  *    - No-prompt fast path: if both prompts are absent, assigns with
  *      `mode: automatic, promptPresence: 'none'` without calling the LLM.
- *    - Otherwise invokes IntentIndexer to get indexScore + memberScore + reasoning.
+ *    - Otherwise invokes the intents indexer to get indexScore + memberScore + reasoning.
  *    - Applies `buildNetworkAssignmentDecision` to produce the threshold/metadata.
  *    - Only writes the link when the decision's `assigned` flag is true.
  *
@@ -49,12 +49,12 @@ export type IntentNetworkState = typeof IntentNetworkGraphState.State;
 /** Everything the intent-network nodes reach for. */
 export interface IntentNetworkGraphDeps {
     database: IntentNetworkGraphDatabase;
-    intentNetworker: IntentIndexer;
+    intentNetworker: IntentNetworkIndexer;
 }
 export declare class IntentNetworkGraphFactory {
     /** Resolved dependency bag shared by every node. */
     readonly deps: IntentNetworkGraphDeps;
-    constructor(database: IntentNetworkGraphDatabase, intentNetworker: IntentIndexer);
+    constructor(database: IntentNetworkGraphDatabase, intentNetworker: IntentNetworkIndexer);
     createGraph(): import("@langchain/langgraph").CompiledStateGraph<{
         userId: string;
         networkId: string | undefined;

package/dist/networks/application/indexer.graph.js

@@ -141,13 +141,13 @@ export async function assignNode(state, deps) {
             const sourceName = intentForIndexing.sourceType
                 ? `${intentForIndexing.sourceType}:${intentForIndexing.sourceId ?? ""}`
                 : undefined;
-            // Run IntentIndexer evaluation (injected from signals public facade via ports)
+            // Score the signal against the network (intents module, injected via ports)
             const _traceEmitter = requestContext.getStore()?.traceEmitter;
             const _indexerStart = Date.now();
             _traceEmitter?.({ type: "agent_start", name: "intent-networker" });
             let result = null;
             try {
-                result = await deps.intentNetworker.evaluate(intentForIndexing.payload, indexPrompt, memberPrompt, sourceName, renderedContext);
+                result = await deps.intentNetworker.indexIntent(intentForIndexing.payload, indexPrompt, memberPrompt, sourceName, renderedContext);
             }
             finally {
                 const _indexerMs = Date.now() - _indexerStart;

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

@@ -21,5 +21,7 @@
  * IND-546: explicit port layer for communities; signals consumed via capabilities/signals.facade.ts.
  */
 export type { NetworkGraphDatabase, NetworkMembershipGraphDatabase, IntentNetworkGraphDatabase, } from "../../shared/interfaces/database.interface.js";
-export { IntentIndexer } from "../../intents/index.js";
-export type { IntentIndexerOutput } from "../../intents/index.js";
+import type { Intents } from "../../intents/intent.module.js";
+/** The one intents method communities calls: score a signal against a network. */
+export type IntentNetworkIndexer = Pick<Intents, "indexIntent">;
+export type { IntentIndexerOutput } from "../../intents/intent.module.js";

package/dist/networks/ports/index.js

@@ -20,8 +20,4 @@
  *
  * IND-546: explicit port layer for communities; signals consumed via capabilities/signals.facade.ts.
  */
-// ── Signal-assignment port ────────────────────────────────────────────────────
-// Re-exported from the signals capability facade so that application-layer code
-// (indexer.graph.ts, indexer.state.ts) imports from the communities port, not
-// directly from the signals facade or its implementation.
-export { IntentIndexer } from "../../intents/index.js";
+export {};

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

@@ -4,7 +4,7 @@
  * Each stage is a top-level function taking the graph state and an explicit
  * dependency bag. `opportunity.graph.ts` wires them into the StateGraph.
  */
-import { IntentIndexer } from '../../intents/index.js';
+import { Intents } from '../../intents/intent.module.js';
 import { withCallLogging } from '../../shared/observability/protocol.logger.js';
 import { timed } from '../../shared/observability/performance.js';
 import { requestContext } from '../../shared/observability/request-context.js';
@@ -200,7 +200,7 @@ export async function scopeNode(state, deps) {
             else if (state.searchQuery?.trim()) {
                 // Chat path: score query against target indexes in parallel
                 try {
-                    const indexer = new IntentIndexer();
+                    const indexer = new Intents();
                     const scopeAgentTimings = [];
                     const scorableIndexes = targetNetworks.filter(ti => ti.title !== 'Unknown');
                     const scoringPromises = scorableIndexes.map(async (ti) => {
@@ -213,7 +213,7 @@ export async function scopeNode(state, deps) {
                         traceEmitter?.({ type: "agent_start", name: "intent-networker" });
                         let result = null;
                         try {
-                            result = await indexer.invoke(state.searchQuery, ctx?.indexPrompt ?? null, ctx?.memberPrompt ?? null);
+                            result = await indexer.indexIntent(state.searchQuery, ctx?.indexPrompt ?? null, ctx?.memberPrompt ?? null);
                         }
                         catch {
                             return { networkId: ti.networkId, score: 1.0 };

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

@@ -111,7 +111,7 @@ export declare const CHAT_DISPLAY_LIMIT = 6;
  *
  * Exported for use in tests (opportunity.tools.spec.ts).
  */
-export declare function buildMinimalOpportunityCard(opp: Opportunity, viewerId: string, counterpartUserId: string, counterpartName: string, counterpartAvatar: string | null, introducerName?: string | null, introducerAvatar?: string | null, viewerName?: string, secondPartyName?: string, secondPartyAvatar?: string | null, secondPartyUserId?: string, isCounterpartGhost?: boolean): {
+export declare function buildMinimalOpportunityCard(opp: Opportunity, viewerId: string, counterpartUserId: string, counterpartName: string, counterpartAvatar: string | null, introducerName?: string | null, introducerAvatar?: string | null, viewerName?: string, secondPartyName?: string, secondPartyAvatar?: string | null, secondPartyUserId?: string): {
     opportunityId: string;
     userId: string;
     name: string;
@@ -131,7 +131,6 @@ export declare function buildMinimalOpportunityCard(opp: Opportunity, viewerId:
     viewerRole: string;
     score: number | undefined;
     status: string;
-    isGhost: boolean;
     secondParty?: {
         name: string;
         avatar?: string | null;

package/dist/opportunities/application/opportunity.tools.cards.js

@@ -172,7 +172,7 @@ export const CHAT_DISPLAY_LIMIT = 6;
  *
  * Exported for use in tests (opportunity.tools.spec.ts).
  */
-export function buildMinimalOpportunityCard(opp, viewerId, counterpartUserId, counterpartName, counterpartAvatar, introducerName, introducerAvatar, viewerName, secondPartyName, secondPartyAvatar, secondPartyUserId, isCounterpartGhost) {
+export function buildMinimalOpportunityCard(opp, viewerId, counterpartUserId, counterpartName, counterpartAvatar, introducerName, introducerAvatar, viewerName, secondPartyName, secondPartyAvatar, secondPartyUserId) {
     const viewerActor = opp.actors.find((a) => a.userId === viewerId);
     const viewerRole = viewerActor?.role ?? "party";
     const introducerActor = opp.actors.find((a) => a.role === "introducer" && a.userId !== viewerId);
@@ -218,7 +218,6 @@ export function buildMinimalOpportunityCard(opp, viewerId, counterpartUserId, co
         viewerRole,
         score,
         status: opp.status ?? "latent",
-        isGhost: isCounterpartGhost ?? false,
         ...(viewerIsIntroducer && secondPartyName
             ? {
                 secondParty: {

package/dist/opportunities/application/opportunity.tools.list.js

@@ -212,7 +212,6 @@ export function createListOpportunitiesTool(defineTool, deps) {
                                 : undefined;
                             const viewerActor = opp.actors.find((a) => a.userId === context.userId);
                             const viewerRole = viewerActor?.role ?? "party";
-                            const isCounterpartGhost = counterpartUser?.isGhost ?? false;
                             try {
                                 // Load the negotiation context alongside presenter context so
                                 // the digest copy can explain *why* the opportunity surfaced
@@ -271,7 +270,6 @@ export function createListOpportunitiesTool(defineTool, deps) {
                                         ? opp.interpretation.confidence
                                         : undefined,
                                     status: opp.status,
-                                    isGhost: isCounterpartGhost,
                                     ...(redeliveryIds.has(opp.id) ? { redelivery: true } : {}),
                                     ...(viewerIsIntroducerHere && secondPartyNameForHeadline
                                         ? {
@@ -371,7 +369,6 @@ export function createListOpportunitiesTool(defineTool, deps) {
                                 : undefined;
                             const viewerActor = opp.actors.find((a) => a.userId === context.userId);
                             const viewerRole = viewerActor?.role ?? "party";
-                            const isCounterpartGhost = counterpartUser?.isGhost ?? false;
                             const [ctx, negotiationContext] = await Promise.all([
                                 gatherOpportunityPresenterContext(presenterDb, opp, context.userId, counterpartUserId),
                                 loadNegotiationContext(deps.negotiationDatabase, opp.id, opp.status),
@@ -417,7 +414,6 @@ export function createListOpportunitiesTool(defineTool, deps) {
                                     ? opp.interpretation.confidence
                                     : undefined,
                                 status: opp.status,
-                                isGhost: isCounterpartGhost,
                                 ...(viewerIsIntroducerHere && secondPartyNameForHeadline
                                     ? {
                                         secondParty: {

package/dist/opportunities/radar/radar.graph.js

@@ -478,7 +478,6 @@ export async function generateCardTextNode(state, deps) {
                         };
                     }
                 }
-                const isCounterpartGhost = otherUser?.isGhost ?? false;
                 // Skeleton presentation: return an identity-only card without the
                 // deps.presenter LLM or negotiation-context load. Name resolution and
                 // the unresolvable-counterpart drop above still apply, so the card
@@ -496,7 +495,6 @@ export async function generateCardTextNode(state, deps) {
                         secondaryActionLabel: SECONDARY_ACTION_LABEL,
                         mutualIntentsLabel: isIntroducer ? 'Connector match' : 'Shared interests',
                         viewerRole,
-                        isGhost: isCounterpartGhost,
                         ...(secondPartyData ? { secondParty: secondPartyData } : {}),
                         presentationPending: true,
                         _cardIndex: cardIndex,
@@ -520,7 +518,6 @@ export async function generateCardTextNode(state, deps) {
                         ? { name: 'You', text: 'Worth a look.', userId: state.userId }
                         : { name: 'Index', text: 'Worth a look.' },
                     viewerRole,
-                    isGhost: isCounterpartGhost,
                     ...(secondPartyData ? { secondParty: secondPartyData } : {}),
                     _presentationFallback: true,
                     _cardIndex: cardIndex,
@@ -580,7 +577,6 @@ export async function generateCardTextNode(state, deps) {
                         mutualIntentsLabel: presentation.mutualIntentsLabel,
                         narratorChip,
                         viewerRole,
-                        isGhost: isCounterpartGhost,
                         ...(secondPartyData ? { secondParty: secondPartyData } : {}),
                         _cardIndex: cardIndex,
                     };

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

@@ -27,8 +27,6 @@ export interface RadarCardItem {
     };
     /** Viewer's role in this opportunity (e.g. 'introducer', 'party', 'agent', 'patient', 'peer'). */
     viewerRole?: string;
-    /** Whether the counterpart is a ghost (not yet onboarded) user. */
-    isGhost?: boolean;
     /** Template-only explanation for a pool-answer demotion (never evaluator reasoning). */
     deprioritizedReason?: string;
     /** Second party in introducer arrow layout. Present when viewerRole is 'introducer'. */

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

@@ -1,12 +1,11 @@
 import { tool } from "@langchain/core/tools";
-import { IntentGraphFactory } from "../../intents/application/intent.graph.js";
+import { Intents } from "../../intents/intent.module.js";
 import { EnrichmentGraphFactory } from "../../enrichment/enrichment.graph.js";
 import { OpportunityGraphFactory } from "../../opportunities/index.js";
 import { HydeGraphFactory } from "../../discovery/hyde.graph.js";
 import { HydeGenerator } from "../../discovery/hyde.generator.js";
 import { LensInferrer } from "../../discovery/lens.inferrer.js";
 import { NetworkGraphFactory, NetworkMembershipGraphFactory, IntentNetworkGraphFactory } from "../../networks/index.js";
-import { IntentIndexer } from "../../intents/application/intent.indexer.js";
 import { NegotiationGraphFactory } from "../../negotiations/index.js";
 import { PremiseGraphFactory } from "../../premises/premise.graph.js";
 import { protocolLogger } from "../observability/protocol.logger.js";
@@ -14,7 +13,6 @@ import { resolveChatContext, error, redactSensitiveFields } from "./tool.helpers
 import { deriveAllowedNetworkIds, focusedIntentId, scopeFromNetworkId } from "./tool.scope.js";
 import { invokeToolRuntime, toolRuntimeErrorToResult } from "./tool.runtime.js";
 import { createEnrichmentTools } from "../../enrichment/enrichment.tools.js";
-import { createIntentTools } from "../../intents/application/intent.tools.js";
 import { createNetworkTools } from "../../networks/index.js";
 import { createOpportunityTools } from "../../opportunities/index.js";
 import { createUtilityTools } from "./utility.tools.js";
@@ -116,7 +114,13 @@ export async function createChatTools(deps, preResolvedContext) {
             ...(resolvedContext.sessionId && !input.conversationId ? { conversationId: resolvedContext.sessionId } : {}),
         })
         : undefined;
-    const intentGraph = new IntentGraphFactory(database, embedder, deps.intentQueue, sessionAwareEnqueue).createGraph();
+    const intents = new Intents({
+        database,
+        embedder,
+        queue: deps.intentQueue,
+        questionerEnqueue: sessionAwareEnqueue,
+    });
+    const intentGraph = intents.createGraph();
     const premiseGraph = new PremiseGraphFactory(database, embedder).createGraph();
     const profileGraph = new EnrichmentGraphFactory(database, scraper, deps.enricher, premiseGraph).createGraph();
     const hydeCache = deps.hydeCache;
@@ -131,7 +135,7 @@ export async function createChatTools(deps, preResolvedContext) {
     negotiationGraph, deps.agentDispatcher, deps.queueNegotiateExisting, deps.stampNewbornOpportunities).createGraph();
     const networkGraph = new NetworkGraphFactory(database).createGraph();
     const networkMembershipGraph = new NetworkMembershipGraphFactory(database).createGraph();
-    const intentNetworkGraph = new IntentNetworkGraphFactory(database, new IntentIndexer()).createGraph();
+    const intentNetworkGraph = new IntentNetworkGraphFactory(database, intents).createGraph();
     // ─── Create context-bound databases ────────────────────────────────────────
     // Use injected instances when provided (e.g. tests). Otherwise create from the same
     // database used for graphs so that scope checks (e.g. ensureScopedMembership, opportunity
@@ -186,7 +190,7 @@ export async function createChatTools(deps, preResolvedContext) {
     };
     // ─── Create domain tools ──────────────────────────────────────────────────
     const profileTools = createEnrichmentTools(defineTool, toolDeps);
-    const intentTools = createIntentTools(defineTool, toolDeps);
+    const intentTools = Intents.createTools(defineTool, toolDeps);
     // An intent-scoped conversation exists to refine its selected signal. Keep
     // creation out of the model-visible registry; the update handler separately
     // clamps writes to the exact scoped intent as a runtime backstop.

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

@@ -187,7 +187,7 @@ interface ToolContextBindings {
     /** Optional durable persistence for reporter cleanup-action proposals. */
     actionProposalStore?: import('../../chat/reporter.action.contracts.js').AgentActionProposalStore;
     /** Durable host persistence for verified intent proposals shown in chat. */
-    intentProposalStore?: import('../../intents/domain/intent.proposal.js').IntentProposalStore;
+    intentProposalStore?: import('../../intents/intent.proposal.js').IntentProposalStore;
     /**
      * Host bridge for the negotiator persona's `remember`/`forget` memory
      * tools (P5.4). Injected by the composition root only when negotiator
@@ -344,7 +344,7 @@ interface ToolDepsBindings {
     /** Context-bound database for LLM/system operations on cross-user resources within shared networks. */
     systemDb: SystemDatabase;
     /** Durable host persistence for verified intent proposals shown in chat. */
-    intentProposalStore?: import('../../intents/domain/intent.proposal.js').IntentProposalStore;
+    intentProposalStore?: import('../../intents/intent.proposal.js').IntentProposalStore;
     scraper: Scraper;
     embedder: import('../interfaces/embedder.interface.js').Embedder;
     cache: Cache;

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

@@ -1,6 +1,6 @@
 import { error, redactSensitiveFields } from './tool.helpers.js';
 import { createEnrichmentTools } from '../../enrichment/enrichment.tools.js';
-import { createIntentTools } from '../../intents/application/intent.tools.js';
+import { Intents } from '../../intents/intent.module.js';
 import { createNetworkTools } from '../../networks/index.js';
 import { createOpportunityTools } from '../../opportunities/index.js';
 import { createUtilityTools } from './utility.tools.js';
@@ -53,7 +53,7 @@ export function createToolRegistry(deps, options = {}) {
     // The local defineTool is compatible with DefineTool (which returns any).
     const dt = defineTool;
     createEnrichmentTools(dt, deps, { surface: isMcpSurface ? 'mcp' : 'rest' });
-    createIntentTools(dt, deps);
+    Intents.createTools(dt, deps);
     createNetworkTools(dt, deps);
     createOpportunityTools(dt, deps);
     // Utility tools always register read_docs + read_activity_summary; on the

package/dist/shared/agent/utility.tools.js

@@ -119,8 +119,7 @@ Contacts are people in a user's personal network, stored as members of their per
 - **Intents**: Signals of interest/need — what a user is looking for (e.g. "Looking for a React developer in Berlin"). Each has a description (payload), summary, confidence score (0-1), inferenceType (explicit/implicit), source tracking, and vector embedding.
 - **IntentNetworks**: Many-to-many junction between Intents and Indexes. An intent can be in multiple indexes. Has a relevancyScore (0-1) indicating how well the intent fits the index's purpose.
 - **Opportunities**: Discovered connections between users based on complementary intents within shared networks. Have actors with roles (introducer, party), status lifecycle, match reasoning, confidence score, and presentation data.
-- **Contacts**: People in a user's personal network, stored as network members with 'contact' permission on the personal network. Can be real users or ghost users (placeholder accounts enriched from public data).
-- **Ghost Users**: Placeholder accounts created for contacts who aren't on the platform yet. Enriched with public profile data (LinkedIn, GitHub) and participate in opportunity matching.
+- **Contacts**: People in a user's personal network, stored as network members with 'contact' permission on the personal network. Established by accepting an opportunity, which adds both people to each other's personal network. Always real accounts.
 
 ### Key Relationships
 - Users → Profiles (1:1)

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

@@ -12,7 +12,7 @@ import type { Database } from './database.port.js';
  *
  * Access layer: Primarily UserDatabase (user's own profile)
  */
-export type EnrichmentGraphDatabase = Pick<Database, 'getProfile' | 'getUser' | 'updateUser' | 'saveProfile' | 'getProfileByUserId' | 'softDeleteGhost' | 'findDuplicateUser' | 'mergeGhostUser' | 'getUserSocials' | 'setUserSocials' | 'getPremisesForUser' | 'getUserContext'> & {
+export type EnrichmentGraphDatabase = Pick<Database, 'getProfile' | 'getUser' | 'updateUser' | 'saveProfile' | 'getProfileByUserId' | 'getUserSocials' | 'setUserSocials' | 'getPremisesForUser' | 'getUserContext'> & {
     /**
      * Optional premise retraction support. When present, write-mode input that
      * disavows existing premises ("remove X", "I have nothing to do with Y")
@@ -37,7 +37,7 @@ export type PremiseGraphDatabase = Pick<Database, 'createPremise' | 'getPremise'
  *
  * Access layer: Both UserDatabase + SystemDatabase (orchestrates all operations)
  */
-export type ChatGraphCompositeDatabase = Pick<Database, 'getProfile' | 'getActiveIntents' | 'getActiveIntentsAcrossIndexes' | 'getIntentsInIndexForMember' | 'getUser' | 'updateUser' | 'getUserSocials' | 'setUserSocials' | 'saveProfile' | 'softDeleteGhost' | 'createIntent' | 'updateIntent' | 'archiveIntent' | 'createOpportunity' | 'createOpportunityIfNetworkEligible' | 'createOpportunityAndExpireIdsIfNetworkEligible' | 'persistIntentScopedOpportunityIfNetworkEligible' | 'updateOpportunityStatusIfNetworkEligible' | 'getOpportunity' | 'getOpportunitiesByIds' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'getOpportunitiesForUser' | 'updateOpportunityStatus' | 'compensateTasklessNegotiatingOpportunity' | 'updateOpportunityActorApproval' | 'stampOpportunityActorAction' | 'getOrCreateDM' | 'getHydeDocument' | 'getHydeDocumentsForSource' | 'saveHydeDocument' | 'getIntent' | 'getPublicIndexesNotJoined' | 'getUserIndexIds' | 'getAssignmentNetworkMembershipsForUser' | 'getAssignmentNetworkIdsForUser' | 'getNetworkMemberships' | 'getNetworkMembership' | 'getActiveNetworkMembershipPairs' | 'getNetwork' | 'getNetworkWithPermissions' | 'getIntentForIndexing' | 'getNetworkMemberContext' | 'getNetworkAssignmentContext' | 'isIntentAssignedToIndex' | 'assignIntentToNetwork' | 'assignIntentToNetworkIfMember' | 'unassignIntentFromIndex' | 'getNetworkIdsForIntent' | 'getIntentIndexScores' | 'getPersonalIndexesForContact' | 'getOwnedIndexes' | 'isIndexOwner' | 'isNetworkMember' | 'getNetworkMembersForOwner' | 'getNetworkMembersForMember' | 'getMembersFromUserIndexes' | 'getNetworkIntentsForOwner' | 'getNetworkIntentsForMember' | 'updateIndexSettings' | 'softDeleteNetwork' | 'deleteProfile' | 'getProfileByUserId' | 'createNetwork' | 'getNetworkMemberCount' | 'addMemberToNetwork' | 'removeMemberFromIndex' | 'findDuplicateUser' | 'mergeGhostUser' | 'getPremisesForUser' | 'getPremisesForUserInNetworks' | 'createPremise' | 'getPremise' | 'updatePremise' | 'assignPremiseToNetwork' | 'getPremiseNetworks' | 'searchPremisesBySimilarity' | 'searchPremisesBySimilarityBatch' | 'getUserContext' | 'getUserContexts' | 'searchIntentsByContextEmbedding' | 'searchUserContextsBySimilarity'> & Pick<NegotiationQueries, 'getNegotiationTaskForOpportunity'>;
+export type ChatGraphCompositeDatabase = Pick<Database, 'getProfile' | 'getActiveIntents' | 'getActiveIntentsAcrossIndexes' | 'getIntentsInIndexForMember' | 'getUser' | 'updateUser' | 'getUserSocials' | 'setUserSocials' | 'saveProfile' | 'createIntent' | 'updateIntent' | 'archiveIntent' | 'createOpportunity' | 'createOpportunityIfNetworkEligible' | 'createOpportunityAndExpireIdsIfNetworkEligible' | 'persistIntentScopedOpportunityIfNetworkEligible' | 'updateOpportunityStatusIfNetworkEligible' | 'getOpportunity' | 'getOpportunitiesByIds' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'getOpportunitiesForUser' | 'updateOpportunityStatus' | 'compensateTasklessNegotiatingOpportunity' | 'updateOpportunityActorApproval' | 'stampOpportunityActorAction' | 'getOrCreateDM' | 'getHydeDocument' | 'getHydeDocumentsForSource' | 'saveHydeDocument' | 'getIntent' | 'getPublicIndexesNotJoined' | 'getUserIndexIds' | 'getAssignmentNetworkMembershipsForUser' | 'getAssignmentNetworkIdsForUser' | 'getNetworkMemberships' | 'getNetworkMembership' | 'getActiveNetworkMembershipPairs' | 'getNetwork' | 'getNetworkWithPermissions' | 'getIntentForIndexing' | 'getNetworkMemberContext' | 'getNetworkAssignmentContext' | 'isIntentAssignedToIndex' | 'assignIntentToNetwork' | 'assignIntentToNetworkIfMember' | 'unassignIntentFromIndex' | 'getNetworkIdsForIntent' | 'getIntentIndexScores' | 'getPersonalIndexesForContact' | 'getOwnedIndexes' | 'isIndexOwner' | 'isNetworkMember' | 'getNetworkMembersForOwner' | 'getNetworkMembersForMember' | 'getMembersFromUserIndexes' | 'getNetworkIntentsForOwner' | 'getNetworkIntentsForMember' | 'updateIndexSettings' | 'softDeleteNetwork' | 'deleteProfile' | 'getProfileByUserId' | 'createNetwork' | 'getNetworkMemberCount' | 'addMemberToNetwork' | 'removeMemberFromIndex' | 'getPremisesForUser' | 'getPremisesForUserInNetworks' | 'createPremise' | 'getPremise' | 'updatePremise' | 'assignPremiseToNetwork' | 'getPremiseNetworks' | 'searchPremisesBySimilarity' | 'searchPremisesBySimilarityBatch' | 'getUserContext' | 'getUserContexts' | 'searchIntentsByContextEmbedding' | 'searchUserContextsBySimilarity'> & Pick<NegotiationQueries, 'getNegotiationTaskForOpportunity'>;
 /**
  * Database interface for Opportunity Graph operations.
  * Includes prep/scope (network membership, intents, index details), persist (create, dedupe),

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

@@ -121,7 +121,6 @@ export interface UserRecord {
     location?: string | null;
     socials: UserSocial[];
     onboarding?: OnboardingState | null;
-    isGhost?: boolean;
     deletedAt?: Date | null;
 }
 /**
@@ -402,8 +401,6 @@ export interface IndexMemberDetails {
     joinedAt: Date;
     /** Count of their intents in this network */
     intentCount: number;
-    /** Whether this user is a ghost (not yet onboarded) */
-    isGhost?: boolean;
 }
 /**
  * Intent details visible to network owners.

package/dist/shared/interfaces/database.identity-queries.d.ts

@@ -44,34 +44,6 @@ export interface DatabaseIdentityQueries {
         label: string;
         value: string;
     }[]): Promise<void>;
-    /**
-     * Soft-delete a ghost user and all their contact memberships.
-     * Used when enrichment determines the entity is not a real person.
-     * @param userId - The ghost user to soft-delete
-     * @returns true if the user was soft-deleted
-     */
-    softDeleteGhost(userId: string): Promise<boolean>;
-    /**
-     * Find an existing user that matches the given social handles.
-     * Checks LinkedIn, GitHub, and Twitter/X handles (case-insensitive, exact match).
-     * Excludes the given userId and soft-deleted users.
-     * Prefers real users over ghosts; among ghosts, returns the oldest.
-     * @param userId - The ghost user being enriched (excluded from results)
-     * @param socials - Enriched social handles to match against
-     * @returns The matching user's id, or null if no match
-     */
-    findDuplicateUser(userId: string, socials: UserSocial[]): Promise<{
-        id: string;
-    } | null>;
-    /**
-     * Merge a ghost user (source) into a target user.
-     * Re-points all data (intents, opportunities, memberships, etc.) from source to target,
-     * deletes ghost-only records (profile, sessions, etc.), and soft-deletes the source user.
-     * Runs in a single transaction.
-     * @param sourceId - The ghost user to merge away
-     * @param targetId - The user to merge into
-     */
-    mergeGhostUser(sourceId: string, targetId: string): Promise<void>;
     /**
      * Retrieves all active (non-archived) intents for a user.
      * Used to populate the `activeIntents` field in the Intent Graph state

package/dist/shared/interfaces/database.member-queries.d.ts

@@ -35,7 +35,6 @@ export interface DatabaseMemberQueries {
             name: string;
             email: string;
             avatar: string | null;
-            isGhost: boolean;
         };
     }>>;
     /** Clear a reverse opt-out (reactivate soft-deleted contact membership in another user's personal network). */
@@ -55,7 +54,6 @@ export interface DatabaseMemberQueries {
         id: string;
         name: string;
         email: string;
-        isGhost: boolean;
     } | null>;
     createPremise(input: {
         userId: string;