@indexnetwork/protocol 14.3.2-rc.477.1 → 17.0.0-rc.479.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.factory.js

@@ -18,7 +18,6 @@ import { createIntentTools } from "../../intents/application/intent.tools.js";
 import { createNetworkTools } from "../../networks/index.js";
 import { createOpportunityTools } from "../../opportunities/index.js";
 import { createUtilityTools } from "./utility.tools.js";
-import { createIntegrationTools } from "../../integrations/index.js";
 import { createContactTools } from "../../contacts/index.js";
 // The composition root reaches the leaf directly (it is exempt from the barrel
 // rule by design): importing agents/index.js here would pull in the
@@ -54,7 +53,6 @@ export async function createChatTools(deps, preResolvedContext) {
             userId: deps.userId,
             networkId: explicitScope.scopeType === 'network' ? explicitScope.scopeId : deps.networkId,
             sessionId: deps.sessionId,
-            contactsEnabled: deps.contactsEnabled,
             actionToolsEnabled: deps.actionToolsEnabled,
         }));
     if (!preResolvedContext && explicitScope.scopeType && explicitScope.scopeId) {
@@ -146,7 +144,6 @@ export async function createChatTools(deps, preResolvedContext) {
     const systemDb = deps.systemDb ?? deps.createSystemDatabase(database, resolvedContext.userId, allowedNetworkIds, embedder);
     // ─── Assemble dependencies ─────────────────────────────────────────────────
     const cache = deps.cache;
-    const integration = deps.integration;
     const toolDeps = {
         database,
         userDb,
@@ -154,10 +151,7 @@ export async function createChatTools(deps, preResolvedContext) {
         scraper,
         embedder,
         cache,
-        integration,
         contactService: deps.contactService,
-        contactsEnabled: deps.contactsEnabled,
-        integrationImporter: deps.integrationImporter,
         enricher: deps.enricher,
         negotiationDatabase: deps.negotiationDatabase,
         negotiationTimeoutQueue: deps.negotiationTimeoutQueue,
@@ -204,7 +198,6 @@ export async function createChatTools(deps, preResolvedContext) {
     const utilityTools = createUtilityTools(defineTool, toolDeps);
     const contactTools = createContactTools(defineTool, toolDeps);
     const agentTools = createAgentTools(defineTool, toolDeps);
-    const integrationTools = createIntegrationTools(defineTool, toolDeps);
     const negotiationTools = deps.agentDispatcher
         ? createNegotiationTools(defineTool, toolDeps)
         : [];
@@ -227,7 +220,6 @@ export async function createChatTools(deps, preResolvedContext) {
         ...networkTools,
         ...opportunityToolsForChat,
         ...utilityTools,
-        ...integrationTools,
         ...contactTools,
         ...agentTools,
         ...negotiationTools,

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";
@@ -5,7 +8,6 @@ import type { UserIdentity } from "../schemas/identity.schema.js";
 import type { ChatGraphCompositeDatabase, CreateOpportunityData, NetworkMembership, UserRecord, UserDatabase, SystemDatabase, NegotiationGraphDatabase } from "../interfaces/database.interface.js";
 import type { Scraper } from "../interfaces/scraper.interface.js";
 import type { Cache, HydeCache } from "../interfaces/cache.interface.js";
-import type { IntegrationAdapter } from "../../integrations/ports/index.js";
 import type { ContactServiceAdapter } from "../../contacts/ports/index.js";
 import type { ProfileEnricher } from "../interfaces/enrichment.interface.js";
 import type { IntentGraphQueue } from "../interfaces/queue.interface.js";
@@ -96,14 +98,6 @@ export interface ResolvedToolContext {
      * which are owner-trusted and receive the full owner view.
      */
     mcpCaller?: McpActivityCaller;
-    /**
-     * True when the CONTACTS_ENABLED feature flag is on. Carried from the
-     * composition root so prompt modules can gate contact-import guidance —
-     * when false/unset, the contacts prompt module is not injected, so the
-     * orchestrator never advertises Gmail import / add_contact (whose tools
-     * are also de-registered). Fail-closed: treat only `true` as enabled.
-     */
-    contactsEnabled?: boolean;
     /** True only when the gated reporter cleanup-action proposal tool is registered. */
     actionToolsEnabled?: boolean;
 }
@@ -139,19 +133,10 @@ interface ToolContextBindings {
     cache: Cache;
     /** Dedicated cache for HyDE graph (may be same instance as cache). */
     hydeCache: HydeCache;
-    /** External integration platform adapter (OAuth, tool actions). */
-    integration: IntegrationAdapter;
     /** Queue for enqueuing follow-up intent processing (HyDE generation/deletion). */
     intentQueue: IntentGraphQueue;
     /** Contact management operations. */
     contactService: ContactServiceAdapter;
-    /**
-     * When false (or unset), the contact import / manual-add tools
-     * (import_contacts, add_contact, import_gmail_contacts) are not registered.
-     * Injected by the composition root from CONTACTS_ENABLED. Read/remove/search
-     * contact tools are always registered.
-     */
-    contactsEnabled?: boolean;
     /** True only when the gated reporter cleanup-action proposal tool is registered. */
     actionToolsEnabled?: boolean;
     /** Chat session reader for loading conversation history. */
@@ -221,15 +206,6 @@ interface ToolContextBindings {
     enricher: ProfileEnricher;
     /** Database adapter for negotiations/conversation operations. */
     negotiationDatabase: NegotiationGraphDatabase;
-    /** Integration importer for bulk contact import from toolkits. */
-    integrationImporter: {
-        importContacts(userId: string, toolkit: string): Promise<{
-            imported: number;
-            skipped: number;
-            newContacts: number;
-            existingContacts: number;
-        }>;
-    };
     /** Factory for user-scoped database access. */
     createUserDatabase: (db: ChatGraphCompositeDatabase, userId: string) => UserDatabase;
     /** Factory for system-scoped database access. */
@@ -316,8 +292,6 @@ export declare function resolveChatContext(params: {
     networkId?: string;
     /** Chat session ID for draft opportunities (stored as context.conversationId). */
     sessionId?: string;
-    /** CONTACTS_ENABLED flag, forwarded onto the resolved context for prompt gating. */
-    contactsEnabled?: boolean;
     /** Reporter action gate forwarded into the persona prompt/context. */
     actionToolsEnabled?: boolean;
 }): Promise<ResolvedToolContext>;
@@ -374,23 +348,7 @@ interface ToolDepsBindings {
     scraper: Scraper;
     embedder: import('../interfaces/embedder.interface.js').Embedder;
     cache: Cache;
-    integration: IntegrationAdapter;
     contactService: ContactServiceAdapter;
-    /**
-     * When false (or unset), the contact import / manual-add tools
-     * (import_contacts, add_contact, import_gmail_contacts) are not registered.
-     * Injected by the composition root from CONTACTS_ENABLED. Read/remove/search
-     * contact tools are always registered.
-     */
-    contactsEnabled?: boolean;
-    integrationImporter: {
-        importContacts(userId: string, toolkit: string): Promise<{
-            imported: number;
-            skipped: number;
-            newContacts: number;
-            existingContacts: number;
-        }>;
-    };
     enricher: ProfileEnricher;
     /** Database adapter for negotiations/conversation operations. */
     negotiationDatabase: NegotiationGraphDatabase;
@@ -493,6 +451,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 +548,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.helpers.js

@@ -16,7 +16,7 @@ export class ChatContextAccessError extends Error {
  * This preloads user identity, profile, network memberships, and scoped index role.
  */
 export async function resolveChatContext(params) {
-    const { database, userId, networkId, sessionId, contactsEnabled, actionToolsEnabled } = params;
+    const { database, userId, networkId, sessionId, actionToolsEnabled } = params;
     const [user, rawProfile, userNetworks, globalContext] = await Promise.all([
         database.getUser(userId),
         database.getProfile(userId),
@@ -93,7 +93,6 @@ export async function resolveChatContext(params) {
         scopedMembershipRole,
         isOnboarding: !(user.onboarding?.completedAt),
         hasName,
-        contactsEnabled,
         actionToolsEnabled,
         ...(sessionId !== undefined ? { sessionId } : {}),
     };

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

@@ -4,7 +4,6 @@ import { createIntentTools } from '../../intents/application/intent.tools.js';
 import { createNetworkTools } from '../../networks/index.js';
 import { createOpportunityTools } from '../../opportunities/index.js';
 import { createUtilityTools } from './utility.tools.js';
-import { createIntegrationTools } from '../../integrations/index.js';
 import { createContactTools } from '../../contacts/index.js';
 import { createAgentTools } from '../../agents/index.js';
 import { createNegotiationTools } from '../../negotiations/index.js';
@@ -53,7 +52,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);
@@ -62,10 +61,9 @@ export function createToolRegistry(deps, options = {}) {
     // (IND-597). The retired report_agent_activity name retains no alias on
     // either surface (IND-605).
     createUtilityTools(dt, deps, { surface: isMcpSurface ? 'mcp' : 'rest' });
-    // Contact/Gmail import tools are omitted from the MCP surface (IND-596). Their
+    // Contact tools are omitted from the MCP surface (IND-596). Their
     // implementations remain available to the REST Tool API and chat agent.
     if (!isMcpSurface) {
-        createIntegrationTools(dt, deps);
         createContactTools(dt, deps);
     }
     createAgentTools(dt, deps);

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

@@ -42,8 +42,6 @@ const ASYNC_CANDIDATE_TOOLS = new Set([
     "create_intent",
     "update_intent",
     "scrape_url",
-    "import_gmail_contacts",
-    "import_contacts",
     "respond_to_negotiation",
     "create_premise",
     "update_premise",

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

@@ -93,23 +93,19 @@ export function createUtilityTools(defineTool, deps, options = {}) {
 
 Contacts are people in a user's personal network, stored as members of their personal network with 'contact' permission.
 
-- **Adding contacts**: Via import_contacts (bulk), add_contact (single email), or import_gmail_contacts (Google integration).
-- **Ghost users**: When a contact email doesn't match an existing account, a ghost user is created. Ghost users are enriched with public profile data and participate in opportunity matching — they can be discovered even before joining the platform.
+- **How contacts arise**: Accepting an opportunity puts both people in each other's personal network. There is no import or manual-add path.
 - **Personal network scope**: Approved signals from personal-network contacts are matched in the background. Use list_opportunities only to review persisted results.
-- **Contact data**: Each contact has userId, name, email, avatar, and isGhost flag.
+- **Contact data**: Each contact has userId, name, email, and avatar.
 
 ### Contact Workflow
-1. import_contacts or import_gmail_contacts → bulk add to network
-2. list_contacts → view all contacts with userId
-3. create_intent or update_intent → create or refine an approved signal for background matching
-4. list_opportunities → review persisted results when background processing finds matches
-5. add_contact(email) → add individual contact
-6. remove_contact(contactUserId) → remove from network`;
+1. list_contacts → view all contacts with userId
+2. create_intent or update_intent → create or refine an approved signal for background matching
+3. list_opportunities → review persisted results when background processing finds matches
+4. remove_contact(contactUserId) → remove from network`;
             const managingContactsWorkflow = `### Managing Contacts
-1. import_gmail_contacts() or import_contacts([...]) → add contacts
-2. list_contacts() → view network
-3. create_intent or update_intent → create or refine an approved signal for background matching
-4. list_opportunities → review persisted results
+1. list_contacts() → view network
+2. create_intent or update_intent → create or refine an approved signal for background matching
+3. list_opportunities → review persisted results
 
 `;
             const sections = {

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'>;