@indexnetwork/protocol 0.1.0 → 0.2.1

package/dist/graphs/opportunity.graph.js

@@ -113,18 +113,18 @@ export class OpportunityGraphFactory {
         const prepNode = withNodeTrace("opportunity-prep", async (state) => timed("OpportunityGraph.prep", async () => withCallLogging(logger, '[Graph:Prep] prepNode', {
             userId: state.userId,
             hasSearchQuery: !!state.searchQuery,
-            requestedIndexId: state.indexId ?? undefined,
+            requestedIndexId: state.networkId ?? undefined,
         }, async () => {
-            // Use getIndexMemberships (all memberships) for search scope — NOT getUserIndexIds
+            // Use getNetworkMemberships (all memberships) for search scope — NOT getUserIndexIds
             // (which filters by autoAssign=true and is intended only for intent assignment).
-            const memberships = await this.database.getIndexMemberships(state.userId);
-            const userIndexIds = memberships.map(m => m.indexId);
-            if (userIndexIds.length === 0) {
-                logger.verbose('[Graph:Prep] User has no index memberships - cannot find opportunities');
+            const memberships = await this.database.getNetworkMemberships(state.userId);
+            const userNetworkIds = memberships.map(m => m.networkId);
+            if (userNetworkIds.length === 0) {
+                logger.verbose('[Graph:Prep] User has no network memberships - cannot find opportunities');
                 return {
-                    userIndexes: [],
+                    userNetworks: [],
                     sourceProfile: null,
-                    error: 'You need to join at least one index to find opportunities.',
+                    error: 'You need to join at least one network to find opportunities.',
                 };
             }
             const discoveryUserId = state.onBehalfOfUserId ?? state.userId;
@@ -147,12 +147,12 @@ export class OpportunityGraphFactory {
                 }
                 : null;
             return {
-                userIndexes: userIndexIds,
+                userNetworks: userNetworkIds,
                 indexedIntents,
                 sourceProfile,
                 trace: [{
                         node: "prep",
-                        detail: `${userIndexIds.length} index(es), ${intents.length} intent(s), ${profile ? 'profile loaded' : 'no profile'}`,
+                        detail: `${userNetworkIds.length} network(s), ${intents.length} intent(s), ${profile ? 'profile loaded' : 'no profile'}`,
                     }],
             };
         }, { context: { userId: state.userId }, logOutput: true }).catch((error) => {
@@ -170,47 +170,49 @@ export class OpportunityGraphFactory {
             const r = result;
             if (r?.error)
                 return `error: ${r.error}`;
-            const indexes = r?.userIndexes;
+            const indexes = r?.userNetworks;
             const intents = r?.indexedIntents;
             return indexes && intents ? `${indexes.length} index(es), ${intents.length} intent(s)` : undefined;
         });
         /**
          * Node 1: Scope
          * Determines which indexes to search within.
-         * If indexId provided: searches only that index.
+         * If networkId provided: searches only that index.
          * Otherwise: searches all user's indexes.
          */
         const scopeNode = withNodeTrace("opportunity-scope", async (state) => {
             return timed("OpportunityGraph.scope", async () => {
                 logger.verbose('[Graph:Scope] Determining search scope', {
-                    requestedIndexId: state.indexId,
-                    userIndexesCount: state.userIndexes.length,
+                    requestedIndexId: state.networkId,
+                    userNetworksCount: state.userNetworks.length,
                 });
                 try {
                     let targetIndexIds;
-                    if (state.indexId) {
-                        // Validate user is member of requested index
-                        if (!state.userIndexes.includes(state.indexId)) {
-                            logger.warn('[Graph:Scope] User not member of requested index', {
-                                indexId: state.indexId,
+                    if (state.networkId) {
+                        // Validate user is member or owner of requested network
+                        const isInScope = state.userNetworks.includes(state.networkId);
+                        const isOwner = !isInScope && await this.database.isIndexOwner(state.networkId, state.userId);
+                        if (!isInScope && !isOwner) {
+                            logger.warn('[Graph:Scope] User not member of requested network', {
+                                networkId: state.networkId,
                             });
                             return {
                                 targetIndexes: [],
-                                error: 'You are not a member of that index.',
+                                error: 'You are not a member of that network.',
                             };
                         }
-                        targetIndexIds = [state.indexId];
+                        targetIndexIds = [state.networkId];
                     }
                     else {
                         // Search all user's indexes
-                        targetIndexIds = state.userIndexes;
+                        targetIndexIds = state.userNetworks;
                     }
                     // Fetch index details
-                    const targetIndexes = await Promise.all(targetIndexIds.map(async (indexId) => {
-                        const index = await this.database.getIndex(indexId);
-                        const memberCount = await this.database.getIndexMemberCount(indexId);
+                    const targetIndexes = await Promise.all(targetIndexIds.map(async (networkId) => {
+                        const index = await this.database.getIndex(networkId);
+                        const memberCount = await this.database.getIndexMemberCount(networkId);
                         return {
-                            indexId,
+                            networkId,
                             title: index?.title ?? 'Unknown',
                             memberCount,
                         };
@@ -225,9 +227,9 @@ export class OpportunityGraphFactory {
                         // Background path: look up persisted scores from intent_indexes
                         try {
                             const scores = await this.database.getIntentIndexScores(state.triggerIntentId);
-                            for (const { indexId, relevancyScore } of scores) {
+                            for (const { networkId, relevancyScore } of scores) {
                                 if (relevancyScore != null) {
-                                    indexRelevancyScores[indexId] = relevancyScore;
+                                    indexRelevancyScores[networkId] = relevancyScore;
                                 }
                             }
                         }
@@ -242,32 +244,35 @@ export class OpportunityGraphFactory {
                             const scopeAgentTimings = [];
                             const scorableIndexes = targetIndexes.filter(ti => ti.title !== 'Unknown');
                             const scoringPromises = scorableIndexes.map(async (ti) => {
+                                const ctx = await this.database.getIndexMemberContext(ti.networkId, state.userId);
+                                if (!ctx?.indexPrompt?.trim() && !ctx?.memberPrompt?.trim()) {
+                                    return { networkId: ti.networkId, score: 1.0 };
+                                }
+                                const _indexerStart = Date.now();
+                                const traceEmitter = requestContext.getStore()?.traceEmitter;
+                                traceEmitter?.({ type: "agent_start", name: "intent-indexer" });
+                                let result = null;
                                 try {
-                                    const ctx = await this.database.getIndexMemberContext(ti.indexId, state.userId);
-                                    if (!ctx?.indexPrompt?.trim() && !ctx?.memberPrompt?.trim()) {
-                                        return { indexId: ti.indexId, score: 1.0 };
-                                    }
-                                    const _indexerStart = Date.now();
-                                    const traceEmitter = requestContext.getStore()?.traceEmitter;
-                                    traceEmitter?.({ type: "agent_start", name: "intent-indexer" });
-                                    const result = await indexer.invoke(state.searchQuery, ctx?.indexPrompt ?? null, ctx?.memberPrompt ?? null);
-                                    const _indexerDuration = Date.now() - _indexerStart;
-                                    traceEmitter?.({ type: "agent_end", name: "intent-indexer", durationMs: _indexerDuration, summary: `Scored index ${ti.indexId}` });
-                                    scopeAgentTimings.push({ name: 'intent.indexer', durationMs: _indexerDuration });
-                                    if (!result)
-                                        return { indexId: ti.indexId, score: 1.0 };
-                                    const score = ctx?.indexPrompt && ctx?.memberPrompt
-                                        ? result.indexScore * 0.6 + result.memberScore * 0.4
-                                        : ctx?.indexPrompt ? result.indexScore : result.memberScore;
-                                    return { indexId: ti.indexId, score };
+                                    result = await indexer.invoke(state.searchQuery, ctx?.indexPrompt ?? null, ctx?.memberPrompt ?? null);
                                 }
                                 catch {
-                                    return { indexId: ti.indexId, score: 1.0 };
+                                    return { networkId: ti.networkId, score: 1.0 };
                                 }
+                                finally {
+                                    const _indexerDuration = Date.now() - _indexerStart;
+                                    traceEmitter?.({ type: "agent_end", name: "intent-indexer", durationMs: _indexerDuration, summary: `Scored index ${ti.networkId}` });
+                                    scopeAgentTimings.push({ name: 'intent.indexer', durationMs: _indexerDuration });
+                                }
+                                if (!result)
+                                    return { networkId: ti.networkId, score: 1.0 };
+                                const score = ctx?.indexPrompt && ctx?.memberPrompt
+                                    ? result.indexScore * 0.6 + result.memberScore * 0.4
+                                    : ctx?.indexPrompt ? result.indexScore : result.memberScore;
+                                return { networkId: ti.networkId, score };
                             });
                             const results = await Promise.all(scoringPromises);
-                            for (const { indexId, score } of results) {
-                                indexRelevancyScores[indexId] = score;
+                            for (const { networkId, score } of results) {
+                                indexRelevancyScores[networkId] = score;
                             }
                             // Accumulate indexer timings into graph state
                             if (scopeAgentTimings.length > 0) {
@@ -331,12 +336,12 @@ export class OpportunityGraphFactory {
                     hasSearchQuery: !!state.searchQuery,
                     indexedIntentsCount: state.indexedIntents.length,
                 });
-                const targetIndexIds = state.targetIndexes.map((t) => t.indexId);
+                const targetIndexIds = state.targetIndexes.map((t) => t.networkId);
                 try {
                     let resolvedIntentId;
                     if (state.triggerIntentId) {
-                        const inIndex = await this.database.getIndexIdsForIntent(state.triggerIntentId);
-                        const inTarget = inIndex.some((id) => targetIndexIds.includes(id));
+                        const inNetwork = await this.database.getNetworkIdsForIntent(state.triggerIntentId);
+                        const inTarget = inNetwork.some((id) => targetIndexIds.includes(id));
                         resolvedIntentId = state.triggerIntentId;
                         const resolvedIntentInIndex = inTarget;
                         const discoverySource = resolvedIntentInIndex ? 'intent' : 'profile';
@@ -351,8 +356,8 @@ export class OpportunityGraphFactory {
                         const matched = state.indexedIntents.find((i) => i.payload?.toLowerCase().includes(q));
                         if (matched) {
                             resolvedIntentId = matched.intentId;
-                            const inIndex = await this.database.getIndexIdsForIntent(matched.intentId);
-                            const resolvedIntentInIndex = inIndex.some((id) => targetIndexIds.includes(id));
+                            const inNetwork = await this.database.getNetworkIdsForIntent(matched.intentId);
+                            const resolvedIntentInIndex = inNetwork.some((id) => targetIndexIds.includes(id));
                             const discoverySource = resolvedIntentInIndex ? 'intent' : 'profile';
                             return {
                                 resolvedTriggerIntentId: resolvedIntentId,
@@ -452,15 +457,15 @@ export class OpportunityGraphFactory {
                         logger.verbose('[Graph:Discovery] Direct-connection mode — bypassing vector search', {
                             targetUserId: state.targetUserId,
                         });
-                        const targetMemberships = await this.database.getIndexMemberships(state.targetUserId);
-                        const targetUserIndexIds = targetMemberships.map(m => m.indexId);
+                        const targetMemberships = await this.database.getNetworkMemberships(state.targetUserId);
+                        const targetUserIndexIds = targetMemberships.map(m => m.networkId);
                         const sharedIndexIds = state.targetIndexes
-                            .filter(ti => targetUserIndexIds.includes(ti.indexId))
-                            .map(ti => ti.indexId);
+                            .filter(ti => targetUserIndexIds.includes(ti.networkId))
+                            .map(ti => ti.networkId);
                         if (sharedIndexIds.length === 0) {
                             logger.warn('[Graph:Discovery] Target user shares no indexes with discoverer', {
                                 targetUserId: state.targetUserId,
-                                discovererIndexes: state.targetIndexes.map(ti => ti.indexId),
+                                discovererIndexes: state.targetIndexes.map(ti => ti.networkId),
                             });
                             return {
                                 candidates: [],
@@ -477,13 +482,13 @@ export class OpportunityGraphFactory {
                         if (targetIntents.length > 0) {
                             // Build one candidate per intent per shared index it belongs to
                             for (const intent of targetIntents) {
-                                const intentIndexIds = await this.database.getIndexIdsForIntent(intent.id);
-                                const overlapping = sharedIndexIds.filter(id => intentIndexIds.includes(id));
-                                for (const indexId of overlapping) {
+                                const intentNetworkIds = await this.database.getNetworkIdsForIntent(intent.id);
+                                const overlapping = sharedIndexIds.filter(id => intentNetworkIds.includes(id));
+                                for (const networkId of overlapping) {
                                     directCandidates.push({
                                         candidateUserId: state.targetUserId,
                                         candidateIntentId: intent.id,
-                                        indexId,
+                                        networkId,
                                         similarity: 1.0,
                                         lens: 'explicit_mention',
                                         candidatePayload: intent.payload,
@@ -498,7 +503,7 @@ export class OpportunityGraphFactory {
                             directCandidates.push({
                                 candidateUserId: state.targetUserId,
                                 candidateIntentId: undefined,
-                                indexId: sharedIndexIds[0],
+                                networkId: sharedIndexIds[0],
                                 similarity: 1.0,
                                 lens: 'explicit_mention',
                                 candidatePayload: '',
@@ -604,7 +609,7 @@ export class OpportunityGraphFactory {
                                 const profileCandidates = [];
                                 for (const targetIndex of state.targetIndexes) {
                                     const results = await this.embedder.searchWithProfileEmbedding(vector, {
-                                        indexScope: [targetIndex.indexId],
+                                        indexScope: [targetIndex.networkId],
                                         excludeUserId: discoveryUserId,
                                         limitPerStrategy: Math.floor(limitPerStrategy / 2),
                                         limit: Math.floor(perIndexLimit / 2),
@@ -614,7 +619,7 @@ export class OpportunityGraphFactory {
                                         profileCandidates.push({
                                             candidateUserId: result.userId,
                                             candidateIntentId: result.type === 'intent' ? result.id : undefined,
-                                            indexId: targetIndex.indexId,
+                                            networkId: targetIndex.networkId,
                                             similarity: result.score,
                                             lens: result.matchedVia,
                                             candidatePayload: '',
@@ -626,7 +631,7 @@ export class OpportunityGraphFactory {
                                 // Merge and dedupe - keep both intent and profile candidates per user
                                 const byKey = new Map();
                                 for (const c of [...queryCandidates, ...profileCandidates]) {
-                                    const key = `${c.candidateUserId}:${c.indexId}:${c.candidateIntentId ?? 'profile'}:${c.discoverySource ?? 'unknown'}`;
+                                    const key = `${c.candidateUserId}:${c.networkId}:${c.candidateIntentId ?? 'profile'}:${c.discoverySource ?? 'unknown'}`;
                                     if (!byKey.has(key) || c.similarity > (byKey.get(key)?.similarity ?? 0)) {
                                         byKey.set(key, c);
                                     }
@@ -656,7 +661,7 @@ export class OpportunityGraphFactory {
                         const allCandidates = [];
                         for (const targetIndex of state.targetIndexes) {
                             const results = await this.embedder.searchWithProfileEmbedding(vector, {
-                                indexScope: [targetIndex.indexId],
+                                indexScope: [targetIndex.networkId],
                                 excludeUserId: discoveryUserId,
                                 limitPerStrategy,
                                 limit: perIndexLimit,
@@ -667,7 +672,7 @@ export class OpportunityGraphFactory {
                                     allCandidates.push({
                                         candidateUserId: result.userId,
                                         candidateIntentId: result.id,
-                                        indexId: targetIndex.indexId,
+                                        networkId: targetIndex.networkId,
                                         similarity: result.score,
                                         lens: result.matchedVia,
                                         candidatePayload: '',
@@ -678,7 +683,7 @@ export class OpportunityGraphFactory {
                                 else {
                                     allCandidates.push({
                                         candidateUserId: result.userId,
-                                        indexId: targetIndex.indexId,
+                                        networkId: targetIndex.networkId,
                                         similarity: result.score,
                                         lens: result.matchedVia,
                                         candidatePayload: '',
@@ -690,7 +695,7 @@ export class OpportunityGraphFactory {
                         }
                         const byUserAndIndex = new Map();
                         for (const c of allCandidates) {
-                            const key = `${c.candidateUserId}:${c.indexId}:${c.candidateIntentId ?? 'profile'}`;
+                            const key = `${c.candidateUserId}:${c.networkId}:${c.candidateIntentId ?? 'profile'}`;
                             if (!byUserAndIndex.has(key) || c.similarity > (byUserAndIndex.get(key)?.similarity ?? 0)) {
                                 byUserAndIndex.set(key, c);
                             }
@@ -793,7 +798,7 @@ export class OpportunityGraphFactory {
                         const all = [];
                         await Promise.all(state.targetIndexes.map(async (targetIndex) => {
                             const results = await self.embedder.searchWithHydeEmbeddings(lensEmbeddings, {
-                                indexScope: [targetIndex.indexId],
+                                indexScope: [targetIndex.networkId],
                                 excludeUserId: discoveryUserId,
                                 limitPerStrategy,
                                 limit: perIndexLimit,
@@ -803,7 +808,7 @@ export class OpportunityGraphFactory {
                                 all.push({
                                     candidateUserId: r.userId,
                                     candidateIntentId: r.id,
-                                    indexId: targetIndex.indexId,
+                                    networkId: targetIndex.networkId,
                                     similarity: r.score,
                                     lens: r.matchedVia,
                                     candidatePayload: '',
@@ -814,7 +819,7 @@ export class OpportunityGraphFactory {
                             for (const r of results.filter((x) => x.type === 'profile')) {
                                 all.push({
                                     candidateUserId: r.userId,
-                                    indexId: targetIndex.indexId,
+                                    networkId: targetIndex.networkId,
                                     similarity: r.score,
                                     lens: r.matchedVia,
                                     candidatePayload: '',
@@ -876,7 +881,7 @@ export class OpportunityGraphFactory {
                     const allCandidates = [];
                     await Promise.all(state.targetIndexes.map(async (targetIndex) => {
                         const results = await this.embedder.searchWithHydeEmbeddings(lensEmbeddings, {
-                            indexScope: [targetIndex.indexId],
+                            indexScope: [targetIndex.networkId],
                             excludeUserId: discoveryUserId,
                             limitPerStrategy,
                             limit: perIndexLimit,
@@ -886,7 +891,7 @@ export class OpportunityGraphFactory {
                             allCandidates.push({
                                 candidateUserId: result.userId,
                                 candidateIntentId: result.id,
-                                indexId: targetIndex.indexId,
+                                networkId: targetIndex.networkId,
                                 similarity: result.score,
                                 lens: result.matchedVia,
                                 candidatePayload: '',
@@ -897,7 +902,7 @@ export class OpportunityGraphFactory {
                         for (const result of results.filter((r) => r.type === 'profile')) {
                             allCandidates.push({
                                 candidateUserId: result.userId,
-                                indexId: targetIndex.indexId,
+                                networkId: targetIndex.networkId,
                                 similarity: result.score,
                                 lens: result.matchedVia,
                                 candidatePayload: '',
@@ -908,7 +913,7 @@ export class OpportunityGraphFactory {
                     }));
                     const byUserAndIndex = new Map();
                     for (const c of allCandidates) {
-                        const key = `${c.candidateUserId}:${c.indexId}:${c.candidateIntentId ?? 'profile'}`;
+                        const key = `${c.candidateUserId}:${c.networkId}:${c.candidateIntentId ?? 'profile'}`;
                         if (!byUserAndIndex.has(key) || c.similarity > (byUserAndIndex.get(key)?.similarity ?? 0)) {
                             byUserAndIndex.set(key, c);
                         }
@@ -1017,7 +1022,7 @@ export class OpportunityGraphFactory {
         });
         /**
          * Node 3: Evaluation (Entity bundle)
-         * Builds entity bundle from source + candidates, invokes entity-bundle evaluator, maps to EvaluatedOpportunity with indexId from entities.
+         * Builds entity bundle from source + candidates, invokes entity-bundle evaluator, maps to EvaluatedOpportunity with networkId from entities.
          */
         const evaluationNode = async (state) => {
             return timed("OpportunityGraph.evaluation", async () => {
@@ -1045,8 +1050,8 @@ export class OpportunityGraphFactory {
                     }
                     else if (c.similarity === existing.similarity) {
                         // Tie-break: prefer index with higher relevancy score
-                        const cScore = state.indexRelevancyScores[c.indexId] ?? 0;
-                        const existingScore = state.indexRelevancyScores[existing.indexId] ?? 0;
+                        const cScore = state.indexRelevancyScores[c.networkId] ?? 0;
+                        const existingScore = state.indexRelevancyScores[existing.networkId] ?? 0;
                         if (cScore > existingScore) {
                             bestByUser.set(c.candidateUserId, c);
                         }
@@ -1100,7 +1105,7 @@ export class OpportunityGraphFactory {
                             payload: i.payload,
                             summary: i.summary,
                         })),
-                        indexId: '', // Placeholder — overwritten per-pairing below
+                        networkId: '', // Placeholder — overwritten per-pairing below
                         ragScore: undefined,
                         matchedVia: undefined,
                     };
@@ -1128,7 +1133,7 @@ export class OpportunityGraphFactory {
                             intents: c.candidateIntentId != null
                                 ? [{ intentId: c.candidateIntentId, payload: intentPayload ?? '', summary: intentSummary }]
                                 : undefined,
-                            indexId: c.indexId,
+                            networkId: c.networkId,
                             ragScore: c.similarity * 100,
                             matchedVia: c.lens,
                         };
@@ -1136,7 +1141,7 @@ export class OpportunityGraphFactory {
                     const userIdToIndexId = new Map();
                     for (const e of candidateEntities) {
                         if (!userIdToIndexId.has(e.userId))
-                            userIdToIndexId.set(e.userId, e.indexId);
+                            userIdToIndexId.set(e.userId, e.networkId);
                     }
                     // Lower default threshold to 50 for better recall
                     const minScore = state.options.minScore ?? 50;
@@ -1297,23 +1302,23 @@ export class OpportunityGraphFactory {
                         actors: op.actors.map((a) => {
                             const isSource = a.userId === discoveryUserId;
                             if (isSource) {
-                                // Source actor inherits the counterpart's indexId (shared match context)
+                                // Source actor inherits the counterpart's networkId (shared match context)
                                 const counterpart = op.actors.find((other) => other.userId !== a.userId);
                                 const counterpartIndexId = counterpart
-                                    ? userIdToIndexId.get(counterpart.userId) ?? candidateEntities.find((e) => e.userId === counterpart.userId)?.indexId
+                                    ? userIdToIndexId.get(counterpart.userId) ?? candidateEntities.find((e) => e.userId === counterpart.userId)?.networkId
                                     : undefined;
                                 return {
                                     userId: a.userId,
                                     role: a.role,
                                     intentId: a.intentId,
-                                    indexId: counterpartIndexId ?? userIdToIndexId.get(a.userId) ?? '',
+                                    networkId: counterpartIndexId ?? userIdToIndexId.get(a.userId) ?? '',
                                 };
                             }
                             return {
                                 userId: a.userId,
                                 role: a.role,
                                 intentId: a.intentId,
-                                indexId: userIdToIndexId.get(a.userId) ?? candidateEntities.find((e) => e.userId === a.userId)?.indexId,
+                                networkId: userIdToIndexId.get(a.userId) ?? candidateEntities.find((e) => e.userId === a.userId)?.networkId,
                             };
                         }),
                     }));
@@ -1457,7 +1462,7 @@ export class OpportunityGraphFactory {
                     },
                 };
                 // Build candidates with enriched context from database.
-                // Each actor carries its own indexId — use it for per-candidate index context.
+                // Each actor carries its own networkId — use it for per-candidate index context.
                 const candidateEntries = state.evaluatedOpportunities
                     .map(opp => {
                     const candidateActor = opp.actors.find(a => a.userId !== discoveryUserId);
@@ -1497,7 +1502,7 @@ export class OpportunityGraphFactory {
                         score: opp.score,
                         reasoning: opp.reasoning,
                         valencyRole: candidateActor.role ?? 'peer',
-                        indexId: candidateActor.indexId,
+                        networkId: candidateActor.networkId,
                         candidateUser: {
                             id: userId,
                             intents: candidateIntents,
@@ -1513,19 +1518,19 @@ export class OpportunityGraphFactory {
                 }));
                 const isChatPath = !!state.options?.conversationId;
                 const maxTurns = isChatPath ? 4 : 6;
-                // Fetch per-candidate index context (group by indexId to avoid duplicate lookups)
-                const uniqueIndexIds = [...new Set(candidates.map(c => c.indexId).filter((id) => !!id))];
+                // Fetch per-candidate index context (group by networkId to avoid duplicate lookups)
+                const uniqueIndexIds = [...new Set(candidates.map(c => c.networkId).filter((id) => !!id))];
                 const indexContextMap = new Map();
-                await Promise.all(uniqueIndexIds.map(async (indexId) => {
-                    const ctx = await this.database.getIndexMemberContext(indexId, discoveryUserId).catch(() => null);
+                await Promise.all(uniqueIndexIds.map(async (networkId) => {
+                    const ctx = await this.database.getIndexMemberContext(networkId, discoveryUserId).catch(() => null);
                     const prompt = [ctx?.indexPrompt, ctx?.memberPrompt]
                         .filter((v) => !!v?.trim())
                         .join('\n\n');
                     if (prompt)
-                        indexContextMap.set(indexId, prompt);
+                        indexContextMap.set(networkId, prompt);
                 }));
                 // Run negotiations per candidate with their actual index context
-                const acceptedResults = await negotiateCandidates(this.negotiationGraph, sourceUser, candidates, { indexId: '', prompt: '' }, // base context, overridden per-candidate below
+                const acceptedResults = await negotiateCandidates(this.negotiationGraph, sourceUser, candidates, { networkId: '', prompt: '' }, // base context, overridden per-candidate below
                 { maxTurns, traceEmitter: traceEmitter ?? undefined,
                     indexContextOverrides: indexContextMap });
                 // Filter opportunities to only those with an opportunity outcome, update scores
@@ -1563,7 +1568,7 @@ export class OpportunityGraphFactory {
                     const limit = state.options.limit ?? 20;
                     const ranked = sorted.slice(0, limit);
                     const actorSetKey = (opp) => opp.actors
-                        .map((a) => `${a.userId}:${a.indexId}`)
+                        .map((a) => `${a.userId}:${a.networkId}`)
                         .sort()
                         .join('|');
                     const seen = new Set();
@@ -1610,37 +1615,46 @@ export class OpportunityGraphFactory {
             return timed("OpportunityGraph.introValidation", async () => {
                 logger.verbose('[Graph:IntroValidation] Starting', {
                     userId: state.userId,
-                    indexId: state.indexId,
+                    networkId: state.networkId,
                     entitiesCount: state.introductionEntities?.length ?? 0,
                 });
                 try {
                     const entities = state.introductionEntities ?? [];
-                    const primaryIndexId = (state.indexId ?? entities[0]?.indexId);
+                    const primaryNetworkId = (state.networkId ?? entities[0]?.networkId);
                     const partyUserIds = [...new Set(entities.map((e) => e.userId).filter((id) => id !== state.userId))];
-                    if (!primaryIndexId || partyUserIds.length < 1) {
+                    if (!primaryNetworkId || partyUserIds.length < 1) {
                         return {
-                            error: 'Introduction requires indexId and at least two entities (introducer + one counterpart).',
+                            error: 'Introduction requires networkId and at least two entities (introducer + one counterpart).',
                         };
                     }
-                    if (state.requiredIndexId && primaryIndexId !== state.requiredIndexId) {
+                    if (state.requiredNetworkId && primaryNetworkId !== state.requiredNetworkId) {
                         return {
                             error: 'This chat is scoped to a different community. You can only introduce members of the current community.',
                         };
                     }
-                    const introducerIsMember = await this.database.isIndexMember(primaryIndexId, state.userId);
-                    if (!introducerIsMember) {
+                    const [introducerIsMember, introducerIsOwner] = await Promise.all([
+                        this.database.isNetworkMember(primaryNetworkId, state.userId),
+                        this.database.isIndexOwner(primaryNetworkId, state.userId),
+                    ]);
+                    if (!introducerIsMember && !introducerIsOwner) {
                         return {
-                            error: 'One or more users are not members of the specified community. You can only introduce members who share an index.',
+                            error: 'One or more users are not members of the specified community. You can only introduce members who share a network.',
                         };
                     }
-                    const partyMemberships = await Promise.all(partyUserIds.map((userId) => this.database.isIndexMember(primaryIndexId, userId)));
-                    const allPartyMembers = partyMemberships.every(Boolean);
+                    const partyInScope = await Promise.all(partyUserIds.map(async (userId) => {
+                        const [isMember, isOwner] = await Promise.all([
+                            this.database.isNetworkMember(primaryNetworkId, userId),
+                            this.database.isIndexOwner(primaryNetworkId, userId),
+                        ]);
+                        return isMember || isOwner;
+                    }));
+                    const allPartyMembers = partyInScope.every(Boolean);
                     if (!allPartyMembers) {
                         return {
-                            error: 'One or more users are not members of the specified community. You can only introduce members who share an index.',
+                            error: 'One or more users are not members of the specified community. You can only introduce members who share a network.',
                         };
                     }
-                    const exists = await this.database.opportunityExistsBetweenActors(partyUserIds, primaryIndexId);
+                    const exists = await this.database.opportunityExistsBetweenActors(partyUserIds, primaryNetworkId);
                     if (exists) {
                         return { error: 'An opportunity already exists between these people.' };
                     }
@@ -1651,7 +1665,7 @@ export class OpportunityGraphFactory {
                     const errMsg = err instanceof Error ? err.message : String(err);
                     logger.error('[Graph:IntroValidation] Failed', {
                         userId: state.userId,
-                        indexId: state.indexId,
+                        networkId: state.networkId,
                         error: err,
                     });
                     return {
@@ -1668,7 +1682,7 @@ export class OpportunityGraphFactory {
         /**
          * Build fallback reasoning and actors when evaluator returns empty or throws.
          */
-        function buildIntroFallback(entities, state, primaryIndexId, introducerName) {
+        function buildIntroFallback(entities, state, primaryNetworkId, introducerName) {
             const reasoning = `${introducerName ?? 'A member'} believes these people should connect.` +
                 (state.introductionHint ? ` Context: ${state.introductionHint}` : '');
             const score = 70;
@@ -1676,7 +1690,7 @@ export class OpportunityGraphFactory {
             const actors = partyUserIds.map((uid) => ({
                 userId: uid,
                 role: 'peer',
-                indexId: primaryIndexId,
+                networkId: primaryNetworkId,
             }));
             return { reasoning, score, actors };
         }
@@ -1691,9 +1705,9 @@ export class OpportunityGraphFactory {
                     return { evaluatedOpportunities: [], agentTimings: [] };
                 }
                 const entities = state.introductionEntities ?? [];
-                const primaryIndexId = (state.indexId ?? entities[0]?.indexId);
-                if (!primaryIndexId || entities.length < 2) {
-                    return { evaluatedOpportunities: [], error: 'Missing entities or index for introduction.', agentTimings: [] };
+                const primaryNetworkId = (state.networkId ?? entities[0]?.networkId);
+                if (!primaryNetworkId || entities.length < 2) {
+                    return { evaluatedOpportunities: [], error: 'Missing entities or network for introduction.', agentTimings: [] };
                 }
                 const agentTimingsAccum = [];
                 let introducerName;
@@ -1728,11 +1742,11 @@ export class OpportunityGraphFactory {
                             userId: a.userId,
                             role: a.role,
                             intentId: a.intentId ?? undefined,
-                            indexId: primaryIndexId,
+                            networkId: primaryNetworkId,
                         }));
                     }
                     else {
-                        const fallback = buildIntroFallback(entities, state, primaryIndexId, introducerName);
+                        const fallback = buildIntroFallback(entities, state, primaryNetworkId, introducerName);
                         reasoning = fallback.reasoning;
                         score = fallback.score;
                         actors = fallback.actors;
@@ -1747,7 +1761,7 @@ export class OpportunityGraphFactory {
                         agentTimingsAccum.push({ name: 'opportunity.evaluator', durationMs: _introErrDuration });
                     }
                     logger.warn('[Graph:IntroEvaluation] Evaluator or getUser failed, using fallback', { error: evalErr });
-                    const fallback = buildIntroFallback(entities, state, primaryIndexId, introducerName);
+                    const fallback = buildIntroFallback(entities, state, primaryNetworkId, introducerName);
                     reasoning = fallback.reasoning;
                     score = fallback.score;
                     actors = fallback.actors;
@@ -1778,7 +1792,7 @@ export class OpportunityGraphFactory {
         };
         /**
          * Node 5: Persist
-         * Creates opportunities from evaluator-proposed actors (indexId, userId, role, optional intent).
+         * Creates opportunities from evaluator-proposed actors (networkId, userId, role, optional intent).
          */
         const persistNode = withNodeTrace("opportunity-persist", async (state) => {
             return timed("OpportunityGraph.persist", async () => {
@@ -1806,18 +1820,18 @@ export class OpportunityGraphFactory {
                         ? await this.database.getUser(state.userId)
                         : null;
                     for (const evaluated of state.evaluatedOpportunities) {
-                        const indexIdForActors = state.indexId ?? evaluated.actors[0]?.indexId;
+                        const indexIdForActors = state.networkId ?? evaluated.actors[0]?.networkId;
                         let actors;
                         let data;
                         logger.verbose('[Graph:Persist:PathSelect]', {
                             isIntroduction: !!state.introductionContext,
                             stateUserId: state.userId,
-                            stateIndexId: state.indexId,
+                            stateIndexId: state.networkId,
                             evaluatedActorUserIds: evaluated.actors.map(a => a.userId),
                         });
                         if (state.introductionContext) {
                             if (indexIdForActors === undefined) {
-                                logger.warn('[Graph:Persist] Introduction path missing indexId; skipping opportunity', {
+                                logger.warn('[Graph:Persist] Introduction path missing networkId; skipping opportunity', {
                                     userId: state.userId,
                                     actorsCount: evaluated.actors.length,
                                 });
@@ -1825,7 +1839,7 @@ export class OpportunityGraphFactory {
                             }
                             // Introduction path: manual detection, introducer actor, curator_judgment signal.
                             const evaluatorActors = evaluated.actors.map((a) => ({
-                                indexId: a.indexId ?? indexIdForActors,
+                                networkId: a.networkId ?? indexIdForActors,
                                 userId: a.userId,
                                 role: a.role,
                                 ...(a.intentId ? { intent: a.intentId } : {}),
@@ -1835,7 +1849,7 @@ export class OpportunityGraphFactory {
                                 ? evaluatorActors
                                 : [
                                     ...evaluatorActors,
-                                    { indexId: indexIdForActors, userId: state.userId, role: 'introducer' },
+                                    { networkId: indexIdForActors, userId: state.userId, role: 'introducer' },
                                 ];
                             data = {
                                 detection: {
@@ -1858,7 +1872,7 @@ export class OpportunityGraphFactory {
                                     ],
                                 },
                                 context: {
-                                    indexId: state.indexId ?? indexIdForActors,
+                                    networkId: state.networkId ?? indexIdForActors,
                                     ...(state.options.conversationId ? { conversationId: state.options.conversationId } : {}),
                                 },
                                 confidence: String(evaluated.score / 100),
@@ -1867,7 +1881,7 @@ export class OpportunityGraphFactory {
                         }
                         else if (state.onBehalfOfUserId) {
                             if (indexIdForActors === undefined) {
-                                logger.warn('[Graph:Persist] Introducer discovery path missing indexId; skipping opportunity', {
+                                logger.warn('[Graph:Persist] Introducer discovery path missing networkId; skipping opportunity', {
                                     userId: state.userId,
                                     actorsCount: evaluated.actors.length,
                                 });
@@ -1875,7 +1889,7 @@ export class OpportunityGraphFactory {
                             }
                             // Introducer discovery path: manual detection, introducer is state.userId, target is onBehalfOfUserId.
                             const evaluatorActors = evaluated.actors.map((a) => ({
-                                indexId: a.indexId ?? indexIdForActors,
+                                networkId: a.networkId ?? indexIdForActors,
                                 userId: a.userId,
                                 role: a.role,
                                 ...(a.intentId ? { intent: a.intentId } : {}),
@@ -1885,7 +1899,7 @@ export class OpportunityGraphFactory {
                                 ? evaluatorActors
                                 : [
                                     ...evaluatorActors,
-                                    { indexId: indexIdForActors, userId: state.userId, role: 'introducer' },
+                                    { networkId: indexIdForActors, userId: state.userId, role: 'introducer' },
                                 ];
                             const candidateUserId = evaluated.actors.find((a) => a.userId !== state.onBehalfOfUserId)?.userId;
                             const overlapping = candidateUserId
@@ -1915,7 +1929,7 @@ export class OpportunityGraphFactory {
                                 if (existing.status !== 'expired' && candidateUserId) {
                                     existingBetweenActors.push({
                                         candidateUserId: candidateUserId,
-                                        indexId: (state.indexId ?? indexIdForActors ?? ''),
+                                        networkId: (state.networkId ?? indexIdForActors ?? ''),
                                         existingOpportunityId: existing.id,
                                         existingStatus: existing.status,
                                     });
@@ -1941,7 +1955,7 @@ export class OpportunityGraphFactory {
                                         }],
                                 },
                                 context: {
-                                    indexId: state.indexId ?? indexIdForActors,
+                                    networkId: state.networkId ?? indexIdForActors,
                                     ...(state.options.conversationId ? { conversationId: state.options.conversationId } : {}),
                                 },
                                 confidence: String(evaluated.score / 100),
@@ -1951,7 +1965,7 @@ export class OpportunityGraphFactory {
                         else {
                             // Discovery path: opportunity_graph source, no introducer, lifecycle guard for agent/patient.
                             const evaluatorActors = evaluated.actors.map((a) => ({
-                                indexId: a.indexId ?? indexIdForActors,
+                                networkId: a.networkId ?? indexIdForActors,
                                 userId: a.userId,
                                 role: a.role,
                                 ...(a.intentId ? { intent: a.intentId } : {}),
@@ -1972,7 +1986,7 @@ export class OpportunityGraphFactory {
                                 }
                             }
                             // Index-agnostic dedup: find ANY existing opportunity between these users,
-                            // regardless of which index it was created in or whether context.indexId is set.
+                            // regardless of which index it was created in or whether context.networkId is set.
                             const candidateUserId = evaluated.actors.find((a) => a.userId !== state.userId)?.userId;
                             logger.verbose('[Graph:Persist:Dedup] Checking overlapping opportunities', {
                                 stateUserId: state.userId,
@@ -1988,7 +2002,7 @@ export class OpportunityGraphFactory {
                             });
                             if (overlapping.length > 0) {
                                 const existing = overlapping[0];
-                                const existingIndexId = (existing.context?.indexId ?? state.indexId ?? state.userIndexes?.[0] ?? '');
+                                const existingIndexId = (existing.context?.networkId ?? state.networkId ?? state.userNetworks?.[0] ?? '');
                                 if (existing.status === 'expired') {
                                     const reactivated = await this.database.updateOpportunityStatus(existing.id, initialStatus);
                                     if (reactivated) {
@@ -2016,7 +2030,7 @@ export class OpportunityGraphFactory {
                                 else if (candidateUserId) {
                                     existingBetweenActors.push({
                                         candidateUserId: candidateUserId,
-                                        indexId: existingIndexId,
+                                        networkId: existingIndexId,
                                         existingOpportunityId: existing.id,
                                         existingStatus: existing.status,
                                     });
@@ -2051,7 +2065,7 @@ export class OpportunityGraphFactory {
                                     ],
                                 },
                                 context: {
-                                    ...(state.indexId ? { indexId: state.indexId } : {}),
+                                    ...(state.networkId ? { networkId: state.networkId } : {}),
                                     ...(state.options.conversationId ? { conversationId: state.options.conversationId } : {}),
                                 },
                                 confidence: String(evaluated.score / 100),
@@ -2124,29 +2138,32 @@ export class OpportunityGraphFactory {
         // CRUD NODES (read, update, delete, send)
         // ═══════════════════════════════════════════════════════════════
         /**
-         * Read Node: List opportunities for the user, optionally filtered by indexId.
+         * Read Node: List opportunities for the user, optionally filtered by networkId.
          * Fast path — no LLM calls.
          */
         const readNode = async (state) => {
             return timed("OpportunityGraph.read", async () => {
                 logger.verbose('[Graph:Read] Listing opportunities', {
                     userId: state.userId,
-                    indexId: state.indexId,
+                    networkId: state.networkId,
                 });
                 try {
                     let indexIdFilter;
-                    if (state.indexId) {
-                        const isMember = await this.database.isIndexMember(state.indexId, state.userId);
-                        if (!isMember) {
+                    if (state.networkId) {
+                        const [isMember, isOwner] = await Promise.all([
+                            this.database.isNetworkMember(state.networkId, state.userId),
+                            this.database.isIndexOwner(state.networkId, state.userId),
+                        ]);
+                        if (!isMember && !isOwner) {
                             return {
-                                readResult: { count: 0, opportunities: [], message: 'Index not found or you are not a member.' },
+                                readResult: { count: 0, opportunities: [], message: 'Network not found or you are not a member.' },
                             };
                         }
-                        indexIdFilter = state.indexId;
+                        indexIdFilter = state.networkId;
                     }
                     const rawList = await this.database.getOpportunitiesForUser(state.userId, {
                         limit: 30,
-                        ...(indexIdFilter ? { indexId: indexIdFilter } : {}),
+                        ...(indexIdFilter ? { networkId: indexIdFilter } : {}),
                     });
                     const list = rawList.filter((opp) => opp.status !== 'expired');
                     if (list.length === 0) {
@@ -2193,10 +2210,10 @@ export class OpportunityGraphFactory {
                         const introducer = opp.actors.find((a) => a.role === 'introducer');
                         const partyIds = otherParties.map((a) => a.userId);
                         const idsToResolve = introducer ? [...partyIds, introducer.userId] : partyIds;
-                        // Use the counterpart's (non-viewer) indexId — it reflects where the match was found.
+                        // Use the counterpart's (non-viewer) networkId — it reflects where the match was found.
                         // actors[0] is typically the viewer with an arbitrary first-target-index value.
                         const counterpartActor = opp.actors.find((a) => a.userId !== state.userId);
-                        const actorIndexId = counterpartActor?.indexId ?? opp.actors[0]?.indexId;
+                        const actorIndexId = counterpartActor?.networkId ?? opp.actors[0]?.networkId;
                         const [indexRecord, ...profileAndUserPairs] = await Promise.all([
                             actorIndexId ? this.database.getIndex(actorIndexId) : Promise.resolve(null),
                             ...idsToResolve.map(async (uid) => {