@indexnetwork/protocol 18.0.0-rc.481.1 → 20.0.0-rc.483.1

package/dist/networks/network.module.js

@@ -0,0 +1,83 @@
+/**
+ * networks — the capability's single public surface.
+ *
+ * Everything the rest of the package (and every host) may reach lives on the
+ * {@link Networks} class. The files beside this one are private implementation,
+ * named for what they do rather than for the layer they sit in:
+ *
+ *   network.graph        the community lifecycle graph — create, read, update, delete
+ *   network.state        that graph's channel state
+ *   membership.graph     the roster graph — add, list, remove members
+ *   membership.state     that graph's channel state
+ *   indexer.graph        signal↔community assignment, direct or model-evaluated
+ *   indexer.state        that graph's channel state
+ *   network.recommender  ranking public communities during onboarding
+ *   network.tools        the agent-facing tool definitions
+ *
+ * No directories: every stage here is one or two files, so a folder per stage
+ * would only add a hop. Nothing outside `networks/` imports any of it; the
+ * layout may change freely as long as this class keeps its shape.
+ */
+import { IntentNetworkGraphFactory } from "./indexer.graph.js";
+import { NetworkMembershipGraphFactory } from "./membership.graph.js";
+import { NetworkGraphFactory } from "./network.graph.js";
+import { createNetworkTools } from "./network.tools.js";
+/**
+ * The networks capability.
+ *
+ * One instance is cheap: it holds its dependencies and compiles a graph only
+ * when asked, so a host can keep a single `Networks` and build just the graphs
+ * it serves.
+ */
+export class Networks {
+    constructor(deps = {}) {
+        this.deps = deps;
+    }
+    // ── Community lifecycle ─────────────────────────────────────────────────────
+    /**
+     * Build the community lifecycle graph — create, read, update, delete.
+     *
+     * @throws If the instance was constructed without a `database`.
+     */
+    createGraph() {
+        return new NetworkGraphFactory(this.database("createGraph")).createGraph();
+    }
+    // ── Roster ──────────────────────────────────────────────────────────────────
+    /**
+     * Build the membership graph — add, list, and remove members, under the
+     * community's join policy and owner authority.
+     *
+     * @throws If the instance was constructed without a `database`.
+     */
+    createMembershipGraph() {
+        return new NetworkMembershipGraphFactory(this.database("createMembershipGraph")).createGraph();
+    }
+    // ── Signal assignment ───────────────────────────────────────────────────────
+    /**
+     * Build the signal↔community assignment graph — link a signal to a community
+     * directly or after model evaluation, and unlink it.
+     *
+     * @throws If the instance was constructed without a `database` or an `indexer`.
+     */
+    createAssignmentGraph() {
+        const { indexer } = this.deps;
+        if (!indexer) {
+            throw new Error("Networks.createAssignmentGraph() requires an `indexer` dependency.");
+        }
+        return new IntentNetworkGraphFactory(this.database("createAssignmentGraph"), indexer).createGraph();
+    }
+    // ── Stateless surface ───────────────────────────────────────────────────────
+    /** Register the agent-facing community tools against a tool definer. */
+    static createTools(defineTool, deps) {
+        return createNetworkTools(defineTool, deps);
+    }
+    // ── Internals ───────────────────────────────────────────────────────────────
+    /** The database, or the error naming the method that needed it. */
+    database(method) {
+        const { database } = this.deps;
+        if (!database) {
+            throw new Error(`Networks.${method}() requires a \`database\` dependency.`);
+        }
+        return database;
+    }
+}

package/dist/networks/{application/network.recommender.d.ts → network.recommender.d.ts}

@@ -28,8 +28,6 @@ export interface NetworkRecommenderInput {
  * (not at module level) so that importing this module does not require
  * OPENROUTER_API_KEY to be set — tests that import communities tools without a
  * live LLM env are unaffected.
- *
- * IND-546: canonical home — previously network/network.recommender.ts.
  */
 export declare class NetworkRecommender {
     private model;

package/dist/networks/{application/network.recommender.js → network.recommender.js}

@@ -9,10 +9,10 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 import { HumanMessage, SystemMessage } from "@langchain/core/messages";
 import { z } from "zod";
-import { log } from "../../shared/observability/log.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 { log } from "../shared/observability/log.js";
+import { Timed } from "../shared/observability/performance.js";
+import { createStructuredModel } from "../shared/agent/model.config.js";
+import { invokeWithAbortSignal } from "../shared/agent/model-signal.js";
 // ─── Response schema ───────────────────────────────────────────────────────────
 export const NetworkRecommenderOutputSchema = z.object({
     rankedNetworkIds: z
@@ -57,8 +57,6 @@ OUTPUT RULES:
  * (not at module level) so that importing this module does not require
  * OPENROUTER_API_KEY to be set — tests that import communities tools without a
  * live LLM env are unaffected.
- *
- * IND-546: canonical home — previously network/network.recommender.ts.
  */
 export class NetworkRecommender {
     constructor() {

package/dist/networks/{domain/network.state.d.ts → network.state.d.ts}

@@ -10,8 +10,6 @@
  * When the chat is network-scoped (`networkId` is set) and `showAll` is false,
  * readNode surfaces only the focused network plus the user's personal network
  * (contacts).  Setting `showAll: true` bypasses the restriction (admin use).
- *
- * IND-546: canonical home — previously network/network.state.ts.
  */
 export declare const NetworkGraphState: import("@langchain/langgraph").AnnotationRoot<{
     /** User performing the action. Always required. */

package/dist/networks/{domain/network.state.js → network.state.js}

@@ -11,8 +11,6 @@ import { Annotation } from "@langchain/langgraph";
  * When the chat is network-scoped (`networkId` is set) and `showAll` is false,
  * readNode surfaces only the focused network plus the user's personal network
  * (contacts).  Setting `showAll: true` bypasses the restriction (admin use).
- *
- * IND-546: canonical home — previously network/network.state.ts.
  */
 export const NetworkGraphState = Annotation.Root({
     // --- Core Inputs (from ChatGraph via ToolContext) ---

package/dist/networks/{application/network.tools.d.ts → network.tools.d.ts}

@@ -1,5 +1,8 @@
-import type { DefineTool } from "../../shared/agent/tool.helpers.js";
-import type { NetworkToolDeps } from "../ports/communities.tools.port.js";
+import type { DefineTool, ToolRegistryCompositionDeps } from "../shared/agent/tool.helpers.js";
+/** Host capabilities consumed by community discovery and membership tools. */
+export type NetworkToolDeps = Pick<ToolRegistryCompositionDeps, "userDb" | "systemDb" | "getUserContextText" | "networkRanker" | "reportToolError"> & {
+    graphs: Pick<ToolRegistryCompositionDeps["graphs"], "index" | "networkMembership">;
+};
 /**
  * Creates all community (network) lifecycle and membership tools.
  *
@@ -29,7 +32,5 @@ import type { NetworkToolDeps } from "../ports/communities.tools.port.js";
  * `context.isOnboarding` is true and public networks are available.  Ranking is
  * performed by `NetworkRecommender` (ambient LLM agent) or a `deps.networkRanker`
  * override, with graceful degradation if ranking fails.
- *
- * IND-546: canonical home — previously network/network.tools.ts.
  */
 export declare function createNetworkTools(defineTool: DefineTool, deps: NetworkToolDeps): readonly [any, any, any, any, any, any, any];

package/dist/networks/{application/network.tools.js → network.tools.js}

@@ -1,9 +1,9 @@
 import { z } from "zod";
-import { requestContext } from "../../shared/observability/request-context.js";
-import { log } from "../../shared/observability/log.js";
-import { renderNetworkContext } from "../../shared/network/metadata.renderer.js";
-import { success, error, UUID_REGEX } from "../../shared/agent/tool.helpers.js";
-import { focusedNetworkId } from "../../shared/agent/tool.scope.js";
+import { requestContext } from "../shared/observability/request-context.js";
+import { log } from "../shared/observability/log.js";
+import { renderNetworkContext } from "../shared/network/metadata.renderer.js";
+import { success, error, UUID_REGEX } from "../shared/agent/tool.helpers.js";
+import { focusedNetworkId } from "../shared/agent/tool.scope.js";
 import { NetworkRecommender } from "./network.recommender.js";
 /**
  * Resolves the community this caller is hard-bound to, if any.
@@ -52,8 +52,6 @@ const logger = log.protocol.from("ChatTools:Network");
  * `context.isOnboarding` is true and public networks are available.  Ranking is
  * performed by `NetworkRecommender` (ambient LLM agent) or a `deps.networkRanker`
  * override, with graceful degradation if ranking fails.
- *
- * IND-546: canonical home — previously network/network.tools.ts.
  */
 export function createNetworkTools(defineTool, deps) {
     const { graphs, userDb, systemDb } = deps;

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

@@ -5,7 +5,7 @@ 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 { Networks } from "../../networks/network.module.js";
 import { NegotiationGraphFactory } from "../../negotiations/index.js";
 import { PremiseGraphFactory } from "../../premises/premise.graph.js";
 import { protocolLogger } from "../observability/protocol.logger.js";
@@ -13,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 { createNetworkTools } from "../../networks/index.js";
 import { createOpportunityTools } from "../../opportunities/index.js";
 import { createUtilityTools } from "./utility.tools.js";
 import { createContactTools } from "../../contacts/index.js";
@@ -133,9 +132,10 @@ export async function createChatTools(deps, preResolvedContext) {
     const opportunityGraph = new OpportunityGraphFactory(database, embedder, compiledHydeGraph, undefined, // evaluator (default)
     undefined, // queueNotification
     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, intents).createGraph();
+    const networks = new Networks({ database, indexer: intents });
+    const networkGraph = networks.createGraph();
+    const networkMembershipGraph = networks.createMembershipGraph();
+    const intentNetworkGraph = networks.createAssignmentGraph();
     // ─── 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
@@ -197,7 +197,7 @@ export async function createChatTools(deps, preResolvedContext) {
     const intentToolsForChat = focusedIntentId(resolvedContext)
         ? intentTools.filter((candidate) => candidate.name !== "create_intent")
         : intentTools;
-    const networkTools = createNetworkTools(defineTool, toolDeps);
+    const networkTools = Networks.createTools(defineTool, toolDeps);
     const opportunityTools = createOpportunityTools(defineTool, toolDeps);
     const utilityTools = createUtilityTools(defineTool, toolDeps);
     const contactTools = createContactTools(defineTool, toolDeps);

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

@@ -1,7 +1,7 @@
 import { error, redactSensitiveFields } from './tool.helpers.js';
 import { createEnrichmentTools } from '../../enrichment/enrichment.tools.js';
 import { Intents } from '../../intents/intent.module.js';
-import { createNetworkTools } from '../../networks/index.js';
+import { Networks } from '../../networks/network.module.js';
 import { createOpportunityTools } from '../../opportunities/index.js';
 import { createUtilityTools } from './utility.tools.js';
 import { createContactTools } from '../../contacts/index.js';
@@ -54,7 +54,7 @@ export function createToolRegistry(deps, options = {}) {
     const dt = defineTool;
     createEnrichmentTools(dt, deps, { surface: isMcpSurface ? 'mcp' : 'rest' });
     Intents.createTools(dt, deps);
-    createNetworkTools(dt, deps);
+    Networks.createTools(dt, deps);
     createOpportunityTools(dt, deps);
     // Utility tools always register read_docs + read_activity_summary; on the
     // MCP surface scrape_url is omitted and read_docs guidance is sanitized

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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "18.0.0-rc.481.1",
+  "version": "20.0.0-rc.483.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/dist/enrichment/enrichment.enricher.d.ts

@@ -1,18 +0,0 @@
-/**
- * Returns true when the enriched name is meaningfully better than the email local-part.
- * A name that is empty, contains '@', or case-insensitively matches the prefix is NOT meaningful.
- */
-export declare function isEnrichedNameMeaningful(email: string, enrichedName: string): boolean;
-/**
- * Decides whether to set {@link users.name} from Parallel `enrichment.identity.name` for ghost users.
- * @remarks Real users (Google login, etc.) are never touched. Ghost users always get
- * their name enriched when Parallel returns a non-empty name that isn't an email.
- * @param user - Current user row (must include `email`, `name`, `isGhost`)
- * @param enrichedName - `enrichment.identity.name` from Parallel (may be untrimmed)
- * @returns True if `users.name` should be updated to the enriched full name
- */
-export declare function shouldEnrichGhostDisplayNameFromParallel(user: {
-    name: string;
-    email: string;
-    isGhost?: boolean | null;
-}, enrichedName: string): boolean;

package/dist/enrichment/enrichment.enricher.js

@@ -1,30 +0,0 @@
-/**
- * Returns true when the enriched name is meaningfully better than the email local-part.
- * A name that is empty, contains '@', or case-insensitively matches the prefix is NOT meaningful.
- */
-export function isEnrichedNameMeaningful(email, enrichedName) {
-    const trimmed = enrichedName.trim();
-    if (!trimmed || trimmed.includes('@'))
-        return false;
-    const localPart = email.split('@')[0].toLowerCase();
-    return trimmed.toLowerCase() !== localPart;
-}
-/**
- * Decides whether to set {@link users.name} from Parallel `enrichment.identity.name` for ghost users.
- * @remarks Real users (Google login, etc.) are never touched. Ghost users always get
- * their name enriched when Parallel returns a non-empty name that isn't an email.
- * @param user - Current user row (must include `email`, `name`, `isGhost`)
- * @param enrichedName - `enrichment.identity.name` from Parallel (may be untrimmed)
- * @returns True if `users.name` should be updated to the enriched full name
- */
-export function shouldEnrichGhostDisplayNameFromParallel(user, enrichedName) {
-    if (!user.isGhost)
-        return false;
-    const trimmed = enrichedName.trim();
-    if (!trimmed || trimmed.includes("@"))
-        return false;
-    // Skip only if exactly the same (case-sensitive)
-    if (user.name.trim() === trimmed)
-        return false;
-    return true;
-}

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

@@ -1,45 +0,0 @@
-/**
- * networks/application — orchestrators, factories, tools, and agents.
- *
- * Re-exports the orchestration tier of the communities capability: graph
- * factories (LangGraph compilations), tool factories, and agent classes.
- *
- * Boundary: application-layer only.  Imports from networks/domain,
- * networks/ports, and shared/ infrastructure — never from runtime/,
- * host implementations, or capability facades (except as injected ports).
- *
- * ## Foreground use cases (participant-directed)
- *
- * - {@link NetworkGraphFactory} — compiles the network lifecycle graph
- *   (create, read, update, delete networks).
- * - {@link NetworkMembershipGraphFactory} — compiles the membership graph
- *   (add, list, remove members; enforces join-policy and owner authority).
- * - {@link IntentNetworkGraphFactory} — compiles the signal assignment graph
- *   (direct or LLM-evaluated intent–network linking; unassign).
- *   IntentIndexer is injected from the signals public facade.
- * - {@link createNetworkTools} — foreground tool factory; accepts compiled graphs
- *   and host deps through communities.tools.port and produces LangChain-compatible
- *   tool arrays for the tool registry.
- *
- * ## Ambient use case (ranking / recommendation)
- *
- * - {@link NetworkRecommender} — LLM-based community ranking used during onboarding
- *   (step 6) to surface the most relevant public communities for a user.  Lazy-
- *   instantiated inside createNetworkTools to avoid requiring OPENROUTER_API_KEY
- *   at import time.
- *
- * ## Application-internal (not in public surface)
- *
- * - {@link IntentNetworkGraphState}, {@link AssignmentResult}, etc. — graph execution
- *   state types used within indexer.graph.ts; available here for consumers that
- *   need the application-layer state shape.
- *
- * IND-546: canonical application home for communities capability previously spread
- * across network/, network/membership/, and network/indexer/.
- */
-export { NetworkGraphFactory } from "./network.graph.js";
-export { NetworkMembershipGraphFactory } from "./membership.graph.js";
-export { IntentNetworkGraphFactory } from "./indexer.graph.js";
-export { IntentNetworkGraphState, type AssignmentResult, type IntentForIndexing, type IndexMemberContext, } from "./indexer.state.js";
-export { NetworkRecommender, NetworkRecommenderOutputSchema, type NetworkRecommenderOutput, type NetworkRecommenderInput, type NetworkRecommenderNetwork, } from "./network.recommender.js";
-export { createNetworkTools } from "./network.tools.js";

package/dist/networks/application/index.js

@@ -1,50 +0,0 @@
-/**
- * networks/application — orchestrators, factories, tools, and agents.
- *
- * Re-exports the orchestration tier of the communities capability: graph
- * factories (LangGraph compilations), tool factories, and agent classes.
- *
- * Boundary: application-layer only.  Imports from networks/domain,
- * networks/ports, and shared/ infrastructure — never from runtime/,
- * host implementations, or capability facades (except as injected ports).
- *
- * ## Foreground use cases (participant-directed)
- *
- * - {@link NetworkGraphFactory} — compiles the network lifecycle graph
- *   (create, read, update, delete networks).
- * - {@link NetworkMembershipGraphFactory} — compiles the membership graph
- *   (add, list, remove members; enforces join-policy and owner authority).
- * - {@link IntentNetworkGraphFactory} — compiles the signal assignment graph
- *   (direct or LLM-evaluated intent–network linking; unassign).
- *   IntentIndexer is injected from the signals public facade.
- * - {@link createNetworkTools} — foreground tool factory; accepts compiled graphs
- *   and host deps through communities.tools.port and produces LangChain-compatible
- *   tool arrays for the tool registry.
- *
- * ## Ambient use case (ranking / recommendation)
- *
- * - {@link NetworkRecommender} — LLM-based community ranking used during onboarding
- *   (step 6) to surface the most relevant public communities for a user.  Lazy-
- *   instantiated inside createNetworkTools to avoid requiring OPENROUTER_API_KEY
- *   at import time.
- *
- * ## Application-internal (not in public surface)
- *
- * - {@link IntentNetworkGraphState}, {@link AssignmentResult}, etc. — graph execution
- *   state types used within indexer.graph.ts; available here for consumers that
- *   need the application-layer state shape.
- *
- * IND-546: canonical application home for communities capability previously spread
- * across network/, network/membership/, and network/indexer/.
- */
-// ── Network lifecycle graph ───────────────────────────────────────────────────
-export { NetworkGraphFactory } from "./network.graph.js";
-// ── Membership graph ──────────────────────────────────────────────────────────
-export { NetworkMembershipGraphFactory } from "./membership.graph.js";
-// ── Signal-assignment (indexer) graph + state ─────────────────────────────────
-export { IntentNetworkGraphFactory } from "./indexer.graph.js";
-export { IntentNetworkGraphState, } from "./indexer.state.js";
-// ── Community ranking agent ───────────────────────────────────────────────────
-export { NetworkRecommender, NetworkRecommenderOutputSchema, } from "./network.recommender.js";
-// ── Tool factory (foreground adapter entry point) ─────────────────────────────
-export { createNetworkTools } from "./network.tools.js";