@indexnetwork/protocol 14.3.2-rc.477.1 → 16.1.1-rc.478.1

package/dist/questions/domain/question.schema.d.ts

@@ -268,40 +268,40 @@ export declare const NegotiationQuestionCandidateSchema: z.ZodEffects<z.ZodObjec
     counterpartyFelicityAuthority: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     networkId: string;
-    opportunityId: string;
     purpose: "uptake" | "stalled_followup" | "inflight_consultation";
     recipientUserId: string;
     recipientIntentId: string;
+    opportunityId: string;
     taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
     counterpartyIntentId?: string | undefined;
     counterpartyFelicityAuthority?: number | undefined;
 }, {
     networkId: string;
-    opportunityId: string;
     purpose: "uptake" | "stalled_followup" | "inflight_consultation";
     recipientUserId: string;
     recipientIntentId: string;
+    opportunityId: string;
     taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
     counterpartyIntentId?: string | undefined;
     counterpartyFelicityAuthority?: number | undefined;
 }>, {
     networkId: string;
-    opportunityId: string;
     purpose: "uptake" | "stalled_followup" | "inflight_consultation";
     recipientUserId: string;
     recipientIntentId: string;
+    opportunityId: string;
     taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
     counterpartyIntentId?: string | undefined;
     counterpartyFelicityAuthority?: number | undefined;
 }, {
     networkId: string;
-    opportunityId: string;
     purpose: "uptake" | "stalled_followup" | "inflight_consultation";
     recipientUserId: string;
     recipientIntentId: string;
+    opportunityId: string;
     taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
     counterpartyIntentId?: string | undefined;
@@ -332,14 +332,14 @@ export declare const NegotiationQuestionProvenanceSchema: z.ZodEffects<z.ZodObje
     questionOrdinal: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
     networkId: string;
-    opportunityId: string;
-    opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-    opportunityUpdatedAt: string;
     purpose: "uptake" | "stalled_followup" | "inflight_consultation";
     recipientUserId: string;
     recipientIntentId: string;
+    opportunityId: string;
     version: 1;
     intentFingerprint: string;
+    opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+    opportunityUpdatedAt: string;
     questionOrdinal: number;
     taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
@@ -349,14 +349,14 @@ export declare const NegotiationQuestionProvenanceSchema: z.ZodEffects<z.ZodObje
     taskUpdatedAt?: string | undefined;
 }, {
     networkId: string;
-    opportunityId: string;
-    opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-    opportunityUpdatedAt: string;
     purpose: "uptake" | "stalled_followup" | "inflight_consultation";
     recipientUserId: string;
     recipientIntentId: string;
+    opportunityId: string;
     version: 1;
     intentFingerprint: string;
+    opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+    opportunityUpdatedAt: string;
     questionOrdinal: number;
     taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
@@ -366,14 +366,14 @@ export declare const NegotiationQuestionProvenanceSchema: z.ZodEffects<z.ZodObje
     taskUpdatedAt?: string | undefined;
 }>, {
     networkId: string;
-    opportunityId: string;
-    opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-    opportunityUpdatedAt: string;
     purpose: "uptake" | "stalled_followup" | "inflight_consultation";
     recipientUserId: string;
     recipientIntentId: string;
+    opportunityId: string;
     version: 1;
     intentFingerprint: string;
+    opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+    opportunityUpdatedAt: string;
     questionOrdinal: number;
     taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
@@ -383,14 +383,14 @@ export declare const NegotiationQuestionProvenanceSchema: z.ZodEffects<z.ZodObje
     taskUpdatedAt?: string | undefined;
 }, {
     networkId: string;
-    opportunityId: string;
-    opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-    opportunityUpdatedAt: string;
     purpose: "uptake" | "stalled_followup" | "inflight_consultation";
     recipientUserId: string;
     recipientIntentId: string;
+    opportunityId: string;
     version: 1;
     intentFingerprint: string;
+    opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+    opportunityUpdatedAt: string;
     questionOrdinal: number;
     taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
@@ -760,14 +760,14 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         questionOrdinal: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
         networkId: string;
-        opportunityId: string;
-        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-        opportunityUpdatedAt: string;
         purpose: "uptake" | "stalled_followup" | "inflight_consultation";
         recipientUserId: string;
         recipientIntentId: string;
+        opportunityId: string;
         version: 1;
         intentFingerprint: string;
+        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+        opportunityUpdatedAt: string;
         questionOrdinal: number;
         taskId?: string | undefined;
         counterpartyUserId?: string | undefined;
@@ -777,14 +777,14 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         taskUpdatedAt?: string | undefined;
     }, {
         networkId: string;
-        opportunityId: string;
-        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-        opportunityUpdatedAt: string;
         purpose: "uptake" | "stalled_followup" | "inflight_consultation";
         recipientUserId: string;
         recipientIntentId: string;
+        opportunityId: string;
         version: 1;
         intentFingerprint: string;
+        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+        opportunityUpdatedAt: string;
         questionOrdinal: number;
         taskId?: string | undefined;
         counterpartyUserId?: string | undefined;
@@ -794,14 +794,14 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         taskUpdatedAt?: string | undefined;
     }>, {
         networkId: string;
-        opportunityId: string;
-        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-        opportunityUpdatedAt: string;
         purpose: "uptake" | "stalled_followup" | "inflight_consultation";
         recipientUserId: string;
         recipientIntentId: string;
+        opportunityId: string;
         version: 1;
         intentFingerprint: string;
+        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+        opportunityUpdatedAt: string;
         questionOrdinal: number;
         taskId?: string | undefined;
         counterpartyUserId?: string | undefined;
@@ -811,14 +811,14 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         taskUpdatedAt?: string | undefined;
     }, {
         networkId: string;
-        opportunityId: string;
-        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-        opportunityUpdatedAt: string;
         purpose: "uptake" | "stalled_followup" | "inflight_consultation";
         recipientUserId: string;
         recipientIntentId: string;
+        opportunityId: string;
         version: 1;
         intentFingerprint: string;
+        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+        opportunityUpdatedAt: string;
         questionOrdinal: number;
         taskId?: string | undefined;
         counterpartyUserId?: string | undefined;
@@ -1152,14 +1152,14 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     purpose?: "uptake" | "stalled_followup" | "inflight_consultation" | "recovery" | undefined;
     negotiation?: {
         networkId: string;
-        opportunityId: string;
-        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-        opportunityUpdatedAt: string;
         purpose: "uptake" | "stalled_followup" | "inflight_consultation";
         recipientUserId: string;
         recipientIntentId: string;
+        opportunityId: string;
         version: 1;
         intentFingerprint: string;
+        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+        opportunityUpdatedAt: string;
         questionOrdinal: number;
         taskId?: string | undefined;
         counterpartyUserId?: string | undefined;
@@ -1246,14 +1246,14 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     purpose?: "uptake" | "stalled_followup" | "inflight_consultation" | "recovery" | undefined;
     negotiation?: {
         networkId: string;
-        opportunityId: string;
-        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-        opportunityUpdatedAt: string;
         purpose: "uptake" | "stalled_followup" | "inflight_consultation";
         recipientUserId: string;
         recipientIntentId: string;
+        opportunityId: string;
         version: 1;
         intentFingerprint: string;
+        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+        opportunityUpdatedAt: string;
         questionOrdinal: number;
         taskId?: string | undefined;
         counterpartyUserId?: string | undefined;
@@ -1340,14 +1340,14 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     purpose?: "uptake" | "stalled_followup" | "inflight_consultation" | "recovery" | undefined;
     negotiation?: {
         networkId: string;
-        opportunityId: string;
-        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-        opportunityUpdatedAt: string;
         purpose: "uptake" | "stalled_followup" | "inflight_consultation";
         recipientUserId: string;
         recipientIntentId: string;
+        opportunityId: string;
         version: 1;
         intentFingerprint: string;
+        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+        opportunityUpdatedAt: string;
         questionOrdinal: number;
         taskId?: string | undefined;
         counterpartyUserId?: string | undefined;
@@ -1434,14 +1434,14 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     purpose?: "uptake" | "stalled_followup" | "inflight_consultation" | "recovery" | undefined;
     negotiation?: {
         networkId: string;
-        opportunityId: string;
-        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-        opportunityUpdatedAt: string;
         purpose: "uptake" | "stalled_followup" | "inflight_consultation";
         recipientUserId: string;
         recipientIntentId: string;
+        opportunityId: string;
         version: 1;
         intentFingerprint: string;
+        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
+        opportunityUpdatedAt: string;
         questionOrdinal: number;
         taskId?: string | undefined;
         counterpartyUserId?: string | undefined;

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

@@ -1,3 +1,6 @@
+import type { Id } from '../interfaces/database.interface.js';
+import type { OpportunityGraphDeps } from '../../opportunities/application/opportunity.graph.shared.js';
+import type { OpportunityMutationOutcome } from '../../opportunities/application/opportunity.graph.modes.js';
 import { z } from "zod";
 import type { ModelConfig } from "./model.config.js";
 import type { ToolScopeType } from "./tool.scope.js";
@@ -493,6 +496,12 @@ interface ToolDepsBindings {
         limit?: number;
         scope?: 'tool' | 'principal';
     }>;
+    /**
+     * The non-discovery opportunity operations (`update_opportunity` and its
+     * send variant). Defaults to the plain functions in
+     * `opportunity.graph.modes.ts`; injected by tests to observe the call.
+     */
+    opportunityOperations?: OpportunityOperations;
     graphs: {
         profile: CompiledGraph;
         intent: CompiledGraph;
@@ -584,4 +593,16 @@ export declare function extractUrls(text: string): string[];
  * @returns A new value with sensitive fields replaced by `"[redacted]"`.
  */
 export declare function redactSensitiveFields(value: unknown): unknown;
+/** The subset of opportunity modes the tool layer invokes. */
+export interface OpportunityOperations {
+    updateOpportunityStatus: (deps: Pick<OpportunityGraphDeps, 'database'>, request: {
+        userId: Id<'users'>;
+        opportunityId: string | undefined;
+        newStatus: string | undefined;
+    }) => Promise<OpportunityMutationOutcome>;
+    sendOpportunity: (deps: Pick<OpportunityGraphDeps, 'database' | 'queueNotification'>, request: {
+        userId: Id<'users'>;
+        opportunityId: string | undefined;
+    }) => Promise<OpportunityMutationOutcome>;
+}
 export {};

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

@@ -4,9 +4,10 @@ import type { OpportunityOwnerApprovalDeps } from '../../opportunities/ports/opp
 export interface CreateToolRegistryOptions {
     /**
      * Tool-surface profile. The default `'rest'` profile (direct HTTP Tool API)
-     * exposes contact/Gmail tools and `scrape_url`. The restricted `'mcp'`
-     * profile omits those surfaces (IND-596/597). Retired profile/profile-run
-     * compatibility aliases are absent from both profiles (IND-373/598).
+     * exposes contact/Gmail tools, `scrape_url`, and `complete_onboarding`. The
+     * restricted `'mcp'` profile omits those surfaces (IND-596/597). Retired
+     * profile/profile-run compatibility aliases are absent from both profiles
+     * (IND-373/598).
      */
     surface?: ToolSurface;
 }

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

@@ -53,7 +53,7 @@ export function createToolRegistry(deps, options = {}) {
     // Create all tool domains -- each one calls defineTool() which populates the registry.
     // The local defineTool is compatible with DefineTool (which returns any).
     const dt = defineTool;
-    createEnrichmentTools(dt, deps);
+    createEnrichmentTools(dt, deps, { surface: isMcpSurface ? 'mcp' : 'rest' });
     createIntentTools(dt, deps);
     createNetworkTools(dt, deps);
     createOpportunityTools(dt, deps);

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

@@ -0,0 +1,100 @@
+/**
+ * Capability-narrowed views of {@link Database}.
+ *
+ * Graphs depend on these rather than the whole port so a graph's data reach is
+ * visible in one line.
+ */
+import type { NegotiationGraphDatabase, NegotiationQueries } from './database.negotiation.js';
+import type { Database } from './database.port.js';
+/**
+ * Database interface narrowed for Profile Graph operations.
+ * Provides full profile lifecycle: read, write, and query mode.
+ *
+ * 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'> & {
+    /**
+     * Optional premise retraction support. When present, write-mode input that
+     * disavows existing premises ("remove X", "I have nothing to do with Y")
+     * retracts them during decomposition. Adapters without it (e.g. the scraped
+     * enrichment adapter) skip retraction — scraped content never disavows.
+     */
+    updatePremise?: Database['updatePremise'];
+};
+/**
+ * Database interface narrowed for Premise Graph operations.
+ * Provides premise lifecycle: create, read, update, and network assignment.
+ *
+ * Access layer: UserDatabase (user's own premises)
+ */
+export type PremiseGraphDatabase = Pick<Database, 'createPremise' | 'getPremise' | 'getPremisesForUser' | 'updatePremise' | 'assignPremiseToNetwork' | 'getPremiseNetworks' | 'getAssignmentNetworkMembershipsForUser' | 'getAssignmentNetworkIdsForUser' | 'getNetworkAssignmentContext' | 'getUserIndexIds' | 'getNetwork' | 'getNetworkMemberContext' | 'findSimilarActivePremise'>;
+/**
+ * Composite database interface for Chat Graph.
+ * Includes direct ChatGraph operations plus all methods needed by
+ * internally composed subgraphs (ProfileGraph, OpportunityGraph, IntentGraph, NetworkGraph).
+ *
+ * Use this type when ChatGraph orchestrates subgraphs internally.
+ *
+ * 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'>;
+/**
+ * Database interface for Opportunity Graph operations.
+ * Includes prep/scope (network membership, intents, index details), persist (create, dedupe),
+ * and CRUD operations (read, update status, send).
+ *
+ * Access layer: SystemDatabase (cross-user opportunity operations)
+ */
+export type OpportunityGraphDatabase = Pick<Database, 'getProfile' | 'createOpportunity' | 'createOpportunityIfNetworkEligible' | 'createOpportunityAndExpireIdsIfNetworkEligible' | 'persistIntentScopedOpportunityIfNetworkEligible' | 'updateOpportunityStatusIfNetworkEligible' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'getUserIndexIds' | 'getNetworkMemberships' | 'getActiveNetworkMembershipPairs' | 'getActiveIntents' | 'getNetworkIdsForIntent' | 'getNetwork' | 'getNetworkMemberCount' | 'getIntentIndexScores' | 'getNetworkMemberContext' | 'getNetworkAssignmentContext' | 'getOpportunity' | 'getOpportunitiesForUser' | 'updateOpportunityStatus' | 'compensateTasklessNegotiatingOpportunity' | 'stampOpportunityActorAction' | 'updateOpportunityActorApproval' | 'isNetworkMember' | 'isIndexOwner' | 'getUser' | 'getOrCreateDM' | 'getIntent' | 'getPremise' | 'getPremisesForUser' | 'getPremisesForUserInNetworks' | 'searchPremisesBySimilarity' | 'searchPremisesBySimilarityBatch' | 'getUserContext' | 'getUserContexts' | 'searchIntentsByContextEmbedding' | 'searchUserContextsBySimilarity' | 'getHydeDocumentsForSource' | 'getRecentlyRejectedOpportunityCounterparties'> & Pick<NegotiationQueries, 'getNegotiationTaskForOpportunity'>;
+export interface OutcomeOutbox {
+    event: unknown;
+    actorResolution: 'selected_intent' | 'unique_owned_scope';
+    result: {
+        inserted: boolean;
+    };
+}
+export type OpportunityControllerDatabase = Pick<Database, 'getOpportunity' | 'getOpportunitiesByIds' | 'findEnrichedReplacementOpportunities' | 'getOpportunitiesForUser' | 'getOpportunitiesForNetwork' | 'resolveOpportunityId' | 'updateOpportunityStatus' | 'createOpportunity' | 'createOpportunityAndExpireIds' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'acceptSiblingOpportunities' | 'isIndexOwner' | 'isNetworkMember' | 'getUser' | 'getNetwork' | 'getNetworkMemberships' | 'getProfile' | 'getActiveIntents' | 'upsertContactMembership' | 'getOrCreateDM' | 'unhideConversation' | 'updateOpportunityActorApproval' | 'stampOpportunityActorAction'>;
+/**
+ * Database interface narrowed for Intent Graph operations.
+ * Provides state population (getActiveIntents), action execution (create/update/archive),
+ * and read operations (query intents; getIntentsInIndexForMember for network-scoped reads).
+ *
+ * Access layer: UserDatabase (mutations on own intents) + SystemDatabase (network-scoped reads)
+ */
+export type IntentGraphDatabase = Pick<Database, 'getActiveIntents' | 'getActiveIntentsAcrossIndexes' | 'getIntentsInIndexForMember' | 'createIntent' | 'updateIntent' | 'archiveIntent' | 'isNetworkMember' | 'getNetworkIntentsForMember' | 'getUser' | 'getProfile' | 'getUserContext' | 'getPersonalIndexesForContact' | 'assignIntentToNetwork'>;
+/**
+ * Database interface narrowed for Network Graph CRUD operations.
+ * Handles create, read, update, delete of indexes (communities).
+ *
+ * Access layer: UserDatabase (CRUD on own networks and memberships)
+ */
+export type NetworkGraphDatabase = Pick<Database, 'getNetworkMemberships' | 'getOwnedIndexes' | 'getPublicIndexesNotJoined' | 'isIndexOwner' | 'isNetworkMember' | 'getNetwork' | 'createNetwork' | 'addMemberToNetwork' | 'updateIndexSettings' | 'softDeleteNetwork' | 'getNetworkMemberCount'>;
+/**
+ * Database interface narrowed for Intent Index Graph operations.
+ * Provides intent/index context and assignment for intent–index evaluation.
+ * (Migrated from the old NetworkGraphDatabase.)
+ *
+ * Access layer: UserDatabase (own intent assignment) + SystemDatabase (index context)
+ */
+export type IntentNetworkGraphDatabase = Pick<Database, 'getIntentForIndexing' | 'getNetworkMemberContext' | 'getNetworkAssignmentContext' | 'getNetwork' | 'isIntentAssignedToIndex' | 'assignIntentToNetworkIfMember' | 'unassignIntentFromIndex' | 'getIntent' | 'isNetworkMember' | 'isIndexOwner' | 'getNetworkIdsForIntent' | 'getNetworkIntentsForMember' | 'getIntentsInIndexForMember'>;
+/**
+ * Database interface narrowed for Network Membership Graph operations.
+ * Handles CRUD for network memberships (add, list, remove members).
+ *
+ * Access layer: SystemDatabase (cross-user membership operations)
+ */
+export type NetworkMembershipGraphDatabase = Pick<Database, 'isNetworkMember' | 'isIndexOwner' | 'getNetworkWithPermissions' | 'addMemberToNetwork' | 'removeMemberFromIndex' | 'getNetworkMembersForMember'>;
+/**
+ * Database interface narrowed for HyDE Graph operations.
+ * Provides HyDE document CRUD and intent lookup for refresh.
+ *
+ * Access layer: UserDatabase (own HyDE) + SystemDatabase (cross-user matching)
+ */
+export type HydeGraphDatabase = Pick<Database, 'getHydeDocument' | 'getHydeDocumentsForSource' | 'saveHydeDocument' | 'getIntent'>;
+/**
+ * Database interface for Radar Graph (opportunity radar view).
+ * Load opportunities, enrich with profile/index, and support presenter context.
+ *
+ * Access layer: UserDatabase (own opportunities and profile)
+ */
+export type RadarGraphDatabase = Pick<Database, 'getOpportunitiesForUser' | 'getOpportunity' | 'getProfile' | 'getActiveIntents' | 'getNetwork' | 'getUser'> & Pick<NegotiationGraphDatabase, 'getNegotiationTaskForOpportunity' | 'getMessagesForConversation' | 'getArtifactsForTask'>;

package/dist/shared/interfaces/database.capabilities.js

@@ -0,0 +1,7 @@
+/**
+ * Capability-narrowed views of {@link Database}.
+ *
+ * Graphs depend on these rather than the whole port so a graph's data reach is
+ * visible in one line.
+ */
+export {};