@indexnetwork/protocol 4.3.4-rc.310.1 → 4.3.4-rc.312.1

package/dist/opportunity/opportunity.tools.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { requestContext } from "../shared/observability/request-context.js";
 import { success, error, UUID_REGEX } from "../shared/agent/tool.helpers.js";
-import { deriveDiscoveryNetworkIds, focusedNetworkId, focusedNetworkLabel } from "../shared/agent/tool.scope.js";
+import { deriveDiscoveryNetworkIds, focusedIntentId, focusedNetworkId, focusedNetworkLabel } from "../shared/agent/tool.scope.js";
 import { MINIMAL_MAIN_TEXT_MAX_CHARS, getPrimaryActionLabel, SECONDARY_ACTION_LABEL } from "./opportunity.labels.js";
 import { viewerCentricCardSummary, narratorRemarkFromReasoning, stripUuids } from "./opportunity.presentation.js";
 import { runDiscoverFromQuery, continueDiscovery } from "./opportunity.discover.js";
@@ -177,6 +177,13 @@ const UPDATE_OPPORTUNITY_BLOCKED_STATUSES = new Set([
     "expired",
     "negotiating",
 ]);
+function matchesSelectedIntentScope(opportunity, viewerId, scope) {
+    if (scope?.scopeType !== 'intent' || !scope.scopeId)
+        return true;
+    if (opportunity.detection?.triggeredBy === scope.scopeId)
+        return true;
+    return opportunity.actors.some((actor) => actor.userId === viewerId && actor.intent === scope.scopeId);
+}
 /**
  * Maximum number of opportunity cards to show per chat response.
  * Sized for `selectByComposition` to fill both feed buckets — up to 3
@@ -515,7 +522,7 @@ export function createOpportunityTools(defineTool, deps) {
                 "'complementary skills for a startup'). Helps the evaluator produce better match reasoning."),
         }),
         handler: async ({ context, query }) => {
-            const scopedNetworkId = focusedNetworkId(context);
+            const scopedNetworkId = focusedNetworkId(context) ?? context.networkId?.trim();
             const scopedIndexLabel = focusedNetworkLabel(context);
             // Strict scope enforcement: when chat is network-scoped, only allow that index
             if (scopedNetworkId &&
@@ -566,7 +573,7 @@ export function createOpportunityTools(defineTool, deps) {
                         userId: context.userId,
                         userName: context.userName,
                         userEmail: context.userEmail,
-                        ...(scopedNetworkId ? { scopeType: 'network', scopeId: scopedNetworkId } : {}),
+                        ...(context.scopeType && context.scopeId ? { scopeType: context.scopeType, scopeId: context.scopeId } : scopedNetworkId ? { scopeType: 'network', scopeId: scopedNetworkId } : {}),
                         ...(context.indexName ? { indexName: context.indexName } : {}),
                         ...(context.sessionId ? { sessionId: context.sessionId } : {}),
                         ...(context.agentId ? { agentId: context.agentId } : {}),
@@ -895,10 +902,15 @@ export function createOpportunityTools(defineTool, deps) {
             const toolDebugSteps = [
                 { step: "resolve_index_scope", detail: `${indexScope.length} index(es)` },
             ];
-            const triggerIntentId = query.intentId?.trim() || undefined;
-            if (triggerIntentId != null && !UUID_REGEX.test(triggerIntentId)) {
+            const contextIntentId = focusedIntentId(context);
+            const requestedIntentId = query.intentId?.trim() || undefined;
+            if (requestedIntentId != null && !UUID_REGEX.test(requestedIntentId)) {
                 return error("Invalid intent ID format.");
             }
+            if (contextIntentId && requestedIntentId && requestedIntentId !== contextIntentId) {
+                return error("This chat is scoped to a different intent.");
+            }
+            const triggerIntentId = contextIntentId ?? requestedIntentId;
             if (query.introTargetUserId?.trim() && query.introTargetUserId.trim() === context.userId) {
                 return error("You cannot discover introductions for yourself. Try regular discovery instead.");
             }
@@ -965,6 +977,7 @@ export function createOpportunityTools(defineTool, deps) {
                 userId: context.userId,
                 sourceType: 'discovery',
                 ...(context.scopeType === 'network' && context.scopeId ? { networkId: context.scopeId } : {}),
+                ...(contextIntentId ? { scopeType: 'intent', scopeId: contextIntentId } : {}),
                 surfacedQuestionIds: new Set(), // Dedup handled at chat.agent level
             });
             const pendingQuestions = pendingQuestionResult.questions;
@@ -1301,13 +1314,21 @@ export function createOpportunityTools(defineTool, deps) {
                 .string()
                 .optional()
                 .describe("Network UUID to filter opportunities to a specific community. Get from read_networks. Defaults to the scoped network in network-scoped chats. Omit to see opportunities across all networks."),
+            scopeType: z
+                .enum(['intent'])
+                .optional()
+                .describe("Optional selected scope type. Use 'intent' to narrow listed opportunities to a selected intent."),
+            scopeId: z
+                .string()
+                .optional()
+                .describe("Selected intent UUID when scopeType is 'intent'. Ignored only when absent."),
             includeDigestMarkers: z
                 .boolean()
                 .optional()
                 .describe("Internal scheduled-digest mode only. When true, includes hidden delivery markers so the digest send pass can confirm only edited-in opportunities."),
         }),
         handler: async ({ context, query }) => {
-            const scopedNetworkId = focusedNetworkId(context);
+            const scopedNetworkId = focusedNetworkId(context) ?? context.networkId?.trim();
             const scopedIndexLabel = focusedNetworkLabel(context);
             // Strict scope enforcement: when chat is network-scoped, only allow that index
             if (scopedNetworkId &&
@@ -1319,6 +1340,25 @@ export function createOpportunityTools(defineTool, deps) {
             if (effectiveIndexId && !UUID_REGEX.test(effectiveIndexId)) {
                 return error("Invalid network ID format.");
             }
+            const contextIntentId = focusedIntentId(context);
+            const rawScopeId = query.scopeId?.trim() || undefined;
+            if (query.scopeType === 'intent' && !rawScopeId) {
+                return error("scopeId required when scopeType is intent.");
+            }
+            if (!query.scopeType && rawScopeId) {
+                return error("scopeType=intent required when scopeId is provided.");
+            }
+            if (rawScopeId && !UUID_REGEX.test(rawScopeId)) {
+                return error("Invalid scope ID format.");
+            }
+            if (contextIntentId && rawScopeId && contextIntentId !== rawScopeId) {
+                return error("This chat is scoped to a different intent.");
+            }
+            const effectiveIntentScope = contextIntentId
+                ? { scopeType: 'intent', scopeId: contextIntentId }
+                : query.scopeType === 'intent' && rawScopeId
+                    ? { scopeType: 'intent', scopeId: rawScopeId }
+                    : {};
             // The MCP/chat surface exposes actionable opportunities.
             // `latent` is included so the introducer-as-viewer can see their unapproved
             // connector-flow cards ("do you know someone for X?"). Other latent visibility
@@ -1331,6 +1371,7 @@ export function createOpportunityTools(defineTool, deps) {
             // sort order can fill the whole window and starve the other section.
             const fetched = await database.getOpportunitiesForUser(context.userId, {
                 networkId: effectiveIndexId,
+                ...effectiveIntentScope,
                 statuses,
                 limit: CHAT_FETCH_LIMIT,
             });
@@ -1399,8 +1440,10 @@ export function createOpportunityTools(defineTool, deps) {
             if (isDigestMode && deduped.length > 0) {
                 const acceptedCounterpartIds = new Set();
                 try {
+                    // effectiveIntentScope scopes the statuses: ["accepted"] suppression fetch.
                     const acceptedOpps = await database.getOpportunitiesForUser(context.userId, {
                         ...(effectiveIndexId ? { networkId: effectiveIndexId } : {}),
+                        ...effectiveIntentScope,
                         statuses: ["accepted"],
                         limit: ACCEPTED_SUPPRESSION_FETCH_LIMIT,
                     });
@@ -1789,12 +1832,39 @@ export function createOpportunityTools(defineTool, deps) {
                 .enum(["pending", "accepted", "rejected", "expired"])
                 .describe("New status: 'pending' = send the draft to the other party, 'accepted' = accept the connection, " +
                 "'rejected' = decline, 'expired' = mark as timed out."),
+            scopeType: z
+                .enum(['intent'])
+                .optional()
+                .describe("Optional selected scope type. Use 'intent' to require this opportunity to belong to a selected intent."),
+            scopeId: z
+                .string()
+                .optional()
+                .describe("Selected intent UUID when scopeType is 'intent'. Must match the chat's focused intent when one exists."),
         }),
         handler: async ({ context, query }) => {
             const opportunityId = query.opportunityId?.trim();
             if (!opportunityId || !UUID_REGEX.test(opportunityId)) {
                 return error("Valid opportunityId required.");
             }
+            const contextIntentId = focusedIntentId(context);
+            const rawScopeId = query.scopeId?.trim() || undefined;
+            if (query.scopeType === 'intent' && !rawScopeId) {
+                return error("scopeId required when scopeType is intent.");
+            }
+            if (!query.scopeType && rawScopeId) {
+                return error("scopeType=intent required when scopeId is provided.");
+            }
+            if (rawScopeId && !UUID_REGEX.test(rawScopeId)) {
+                return error("Invalid scope ID format.");
+            }
+            if (contextIntentId && rawScopeId && contextIntentId !== rawScopeId) {
+                return error("This chat is scoped to a different intent.");
+            }
+            const effectiveIntentScope = contextIntentId
+                ? { scopeType: 'intent', scopeId: contextIntentId }
+                : query.scopeType === 'intent' && rawScopeId
+                    ? { scopeType: 'intent', scopeId: rawScopeId }
+                    : {};
             // Always fetch the opportunity — needed for actor guard and state machine
             const opportunity = await systemDb.getOpportunity(opportunityId);
             if (!opportunity) {
@@ -1816,13 +1886,16 @@ export function createOpportunityTools(defineTool, deps) {
             // Mirrors the per-actor filter in getOpportunitiesForUser — relying on
             // a focus-scope id or any-actor matches would let a counterpart's network
             // presence shadow a viewer whose own actor is elsewhere.
-            const scopedNetworkId = focusedNetworkId(context);
+            const scopedNetworkId = focusedNetworkId(context) ?? context.networkId?.trim();
             if (scopedNetworkId) {
                 const callerOnBoundNetwork = opportunity.actors?.some((a) => a.userId === context.userId && a.networkId === scopedNetworkId);
                 if (!callerOnBoundNetwork) {
                     return error("Opportunity not found.");
                 }
             }
+            if (!matchesSelectedIntentScope(opportunity, context.userId, effectiveIntentScope)) {
+                return error("Opportunity not found.");
+            }
             const isSend = query.status === "pending";
             const _updateGraphStart = Date.now();
             const _updateTraceEmitter = requestContext.getStore()?.traceEmitter;